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PREFACE 



The information included in this manual is provided by Hewlett Packard to describe the 
internal organization of MPE. It is not intended to be a guide to the modification of MPE. 

Any modification of the tables presented in this manual by HP 3000 users is strongly dis- 
couraged as serious damage to the operating system may result. Furthermore, 
Hewlett-Packard will not support, correct, or attend to any resulting modification of the 
MPE Operating System Software. 

It is not the intention of Hewlett-Packard to update this manual on any scheduled basis. 
Hewlett-Packard is not responsible for problems arising from inaccuracies existing in this 
manual, nor is it responsible for the correction of any inaccuracies. 
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1 - 
2 
3 
k 

5 
6 

7 
8 

9 

10 

11 


--> 

\ 

i 

> 

i 
/ 




ABSOLUTE MEM LOG 

1 


CSTI 


i (BASE OF CST TABLE) 
CSTXB 


CURRENTLY EXE- 
CUTING CST EX- 
TENSION POINTER 


2 


DSTB 


3 


PCBB 




h 


CPCB 


(CURRENT PCB POINTER) 




5 


QI 


(INITIAL Q FOR ICS) 




6 


ZI 


(INITIAL Z FOR ICS) 




7 


MASK WORD 




10 


DRT BANK 




11 


DRT ADDRESS 




12 


RESERVED 


RESERVED FOR 
LOADER MAPPING 
FIRMWARE 


13 


RESERVED 


11* 









15 


P-LABEL FOR INTERRUPT HNDLR 




16 


DB SET FOR INTERRUPT HNDLR 




17 


U| INTERRUPT INTERVAL VALUE 





u: set ir clock lircerrace nas oeen usea since coj.aj.oaa 



NOTE: ALL POINTERS ARE ABSOLUTE ADDRESSES. 
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FIXED LOW MEMORY (SERIES 30/33) 



1 
2 

3 
k 

5 
6 

7 
10 
11 
12 
13 
1U 

15 
16 

17 
20 
21 
22 

23 
2U 



CSTB (BASE OF CST TABLE)** 
CSTXP ** 



DSTB (BASE OF DST TABLE)** 
PCBB (BASE OF PCB TABLE)** 



CPCB (CURRENT PCB POINTER)** 
QI (INITIAL Q FOR ICS)** 



ZI (INITIAL Z FOR ICS)** 
SYSTEM INTERRUPT MASK WORD** 



DRTBANK (BANK OF THE DRT TABLE) 
DRTADDR (BASE OF DRT TABLE) 



DBBANK (FOR INITIAL'S STACK)* 
DB (FOR INITIAL'S STACK)* 



LR (INTERRUPT INTERVAL )+ 
TEMPLR (TEMP STOREAGE OF LIMIT REG)+ 



PCLC (PROCESS CLOCK LAST COUNT)** 
PCHI (PROCESS TIME - MSW)** 



DEC 


1 -- 

2 

3 

k 

5 
6 

7 
8 

9 

10 

11 

12 

13 

Ik 

15 
16 

17 
18 
19 
20 



■> CURRENTLY EX- 
ECUTING CST 
EXTENSION BLOCK 
POINTER 
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FIXED LOW MEMORY (SERIES 30/33) (CONT) 



251 


PCLO (PROCESS TIME - LSW)** \ 


26! 


SCST (SYSTEM CLOCK STATUS)** |: 


271 


SCLC (SYSTEM CLOCK LAST COUNT)** | 


30-371 1 



21 

22 
1 23 
| 2U-31 



NOTE: ALL POINTERS ARE ABSOLUTE ADDRESSES. 



LEGEND: ** NEEDED BY FIRMWARE AND/OR BY SYSTEM, ALWAYS 
* NEEDED DURING INITIAL 
+ NEEDED BY MPE, SET UP BY INITIAL OR PROGENITOR. 
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FIXED LOW MEMORY (SERIES kk) 

% - -DEC 

0| CSTB (BASE OF CST TABLE)** |0 

1| CSTXP * # |1 --> CURRENTLY EX- 
— - ECUTING CST 

2 | DSTB (BASE OF DST TABLE)** |2 EXTENSION BLOCK 
POINTER 

3| PCBB (BASE OF PCB TABLE)** |3 

U| CPCB (CURRENT PCB POINTER)** |l4 

51 QI (INITIAL Q FOR ICS)** |5 

6 | ZI (INITIAL Z FOR ICS)** \6 

71 SYSTEM INTERRUPT MASK WORD** |7 

10 | DRTBANK (BANK OF DRT TABLE) |8 

11| DRTADDR (BASE OF DRT TABLE) |9 

12 | DBBANK (FOR INITIAL'S STACK) |10 

131 DB (FOR INITIAL'S STACK) | 11 

1U| |12 

151 113 

16 1 111* 

171 U5 

20| |16 

21 1 LR (INTERRUPT INTERVAL)* |17 

22 | TEMPLR (TEMP STOREAGE OF LIMIT REG)+ |18 

231 LR (SYSTEM CLOCK LIMIT REGISTER) |19 
2U| ///////////////////////////////////////////// | 20 



1-lt 



FIXED LOW MEMORY (SERIES kk) (CONT) 

25| TR (TIME SINCE LAST SOFT TIMER INTERRUPT) | 21 

26 | SCST (SYSTEM CLOCK STATUS)** | 22 

271 SCLC (SYSTEM CLOCK LAST COUNT)** | 23 

30-371 I 2U-31 

NOTE: ALL POINTERS ARE ABSOLUTE ADDRESSES. 

LEGEND: ** NEEDED BY FIRMWARE AND/OR BY SYSTEM, ALWAYS 
* NEEDED DURING INITIAL 
+ NEEDED BY MPE, SET UP BY INITIAL OR PROGENITOR. 
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SYSTEM GLOBAL AREA 



octal 



name 



o| 


SYSGLOB - SYSBASE 


11 


CST BASE - SYS BASE 


2| 


DST BASE - SYS BASE 


31 


PCB BASE - SYS BASE 


M 


ARSBM BASE - SYS BASE 


51 


IOQ BASE - SYS BASE 


6| 


SBUF BASE - SYS BASE 


71 


ICS QI - SYS BASE 


10 1 


LPDT BASE - SYS BASE 


111 


STOPS BASE - SYS BASE 


12 1 


TRL BASE - SYS BASE 


131 


JCUT BASE - SYS BASE 


11+ 1 


SIR BASE - SYS BASE 


151 


JPCNT BASE - SYS BASE 


16 1 


TBUF BASE - SYS BASE 


171 


MONBUF BASE - SYS BASE 


20 1 
21 1 


FIRST FREE MEMORY ADDRESS 


22| 
231 


TIME OF LAST CYCLE j 


2U| 


RESERVED | 


251 


SWAPTAB BASE - SYSBASE 1 



SYSCST 

SYSDST 

SYSPCB 

SYSARSBM 

SYSIOQ 

SYSBUF 

SYSICS 

SYSLPDT 

SYSBPT 

SYSTRL 

SYSSIR 

SYSSDCTAB 

SYSJPCNT 

SYSBUF 

SMONBUF 



SYSSWAPTAB 
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26| 

27! 
30 1 
31! 
32! 
331 
3U| 
351 
36| 
371 
Uo| 
1+1 1 
h2| 

1*31 

hk\ 

U5! 
U6| 

U7I 
50 1 

5H 



531 



el. I 



VDSMTAB BASE- S7SBASE 



CURRENT CST BLOCK INDEX 



DISCREQTAB BASE - SYS BASE 



DISPLACEMENT TO CODE =€CST ( ) -gDST ( ) 



DISPLACEMENT TO SHARABLE = @CST(LAST)-€DST(0) 



Not in use 



ABS ADDRESS (SYSDIT(8)) 



Not in use 



Not in use 



RESERVED FOR INITIAL (VDSENTRY) 



RESERVED FOR INITIAL (VDSMAP) 



SRTTAB BASE - SYS BASE 



SPECQ HEAD - SYS BASE 
ARL BASE - SYS BASE 



# PAGES IN LARGEST CURRENTLY AVAILABLE REGION 



MAKE OVERLAY CANDIDATE INFORMATION 



NUMBER OF MEMORY BANKS CONFIGURED -1 
SCHEDULER TO AWAKE MESSAGE 



POINTER TO CSTBLK TABLE 



WAIT TO SCHEDULER MESSAGE 



i^TTDlSf Xtrn Af-MTlTTTTrmr *C TlDTADTrmr 
VUlUUmj. AV11Y111 U tlUVlUll 



VDSMTAB 

CSTBX 

SYSDISCREQTAB 

DFC 

DFS 

SYSDIT8 



SRTTAB 

SYSSPECQHEAD 

SYSARLD 

SYSMAXAVAILREG 

MOCINFO 

SYSNBANKS 

SCHEDTOAWAKEMSG 

CSTXBLOCKPOINTER 



lr«TTDAr«TmoT 

j vuiuivaa m. 
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SYSTEM GLOBAL AREA (cont) 



octal 



name 





/55I 
1561 
1571 
|6o| 
|6l| 
|62| 
1631 

\6k\ 

< | 

1651 
|66| 

1671 
I70| 
1 TH 

I72| 

1731 

\7M 

1 751 
1 1- 
1 76| 
1 1- 
1 771 
1 1- 
liooj 

|101| 

1 1- 




BUSY TABLE POINTER 




|BUSY 






HEAD TABLE POINTER 




I HEAD 






TAIL TABLE POINTER 




ITAIL 






# OF SIO PROGRAMS EXECUTING 


ISIOCOUNT 






PARITY ERROR FLAG (MEM 


PE) 


| PARITY 




Impeded queue head for message 


buffer (PIN) 


| IOMSGPIN 




(0:1) 
(1:1) 


I/O Message system error flags 

- No SYSBUF avail for I/O error logging 

- No SYSBUF for IOMESSAGE (GENMSG) 


| IOLOGQX 


reserved 
for I/O 
system 




# OF TERMINALS READING 


RDCOUNT 




# OF TERMINALS WRITING 


WRTCOUNT 






DSET B 




CRIO 






LAST TIMER 




CRIO 
CRIO 






HIGHEST DRT NUMBER 




HSYSDRT 






POWERFAIL 




POWERFAIL 






SYSTEM UP FLAG 




SYSUP 






SYS CONSOLE LOGICAL DEVICE 


NUMBER 


CONSLDEV 






COLD LOAD COUNT 




CLOADID 






SHARED FCB DST 




SHFCBDST 






MONITORING FLAGS 






reserved 
for file* 
system 




MAX # OF SPOOL SECTORS 




MAXSSECT 
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|102 

1 

1 1 ni 

1 


CURRENT # OF SPOOL KILOSECTORS 


1 

\ioU 


# SECTOR/SPOOFLE EXTENT 


105 


MAX CODE SEGMENT SIZE 


106 


MAX # OF CODE SEGMENTS /PROCESS 


107 


MAX STACK SIZE (MAXDATA) 


110 


DEFAULT STACK SIZE 


ill 


MAX EXTRA DATA SEGMENT SIZE 


112 


MAX # EXTRA DATA SEGMENTS/PROCESS 


113 


DST number for MESSAGE buffers 


llU 


UPDATE LEVEL 


115 


FIX LEVEL 


116 


VERSION LEVEL 


117 


DEFAULT CPU TIME LIMIT 


120 


# OF SECONDS TO LOGON 


121 
122 


JOBSYNCH BITS (13:3) 
EXTERNAL PLABEL OF INITIATE 


123 


INTERNAL PLABEL OF INITIATE 


12U 


MAXSYSDST 


125 


MAXSYSCST 


12b 


SL. PUB. SYS LDEV i SL. PUB. SYS 


127 


DISC ADDRESS 


130 
131 


(DIRECTORY) 
(DISC ADDRESS) 



NUMSSECT 



EXTSSECT 



UPDATEL 

FIXL 

VERSION 
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SYSTEM GLOBAL AREA (cont) 



octal 



name 



reserved< 
for CS 



132 1 


SPOOLINDEX 




/133I 
| | 


EXT LABEL FOR SHOWCOM 




U3UI 
j j 






U35I 


CS IOWAIT PLABEL 




U36| 
1 


I CS FIX LEVEL 




U37I 
| | 


CS VERSION 




\1U0| 


CCLOSE PLABEL 




lUll 


LOGICAL PROCESS TABLE (PROGEN) 





1U2| 


IIIIIIIIIIIIIIIIIIIIIIIIIIIUUHIIIIIIIIIIIIII 


lU3l 


LOGICAL PROCESS TABLE (UCOP) 


2 


lkk\ 


LOGICAL PROCESS TABLE (PFAIL) 


3 


li+5| 


LOGICAL PROCESS TABLE (DEVREC) 


It 


lk6\ 


LOGICAL PROCESS TABLE (DRUSG) 


5 


ll*7l 


LOGICAL PROCESS TABLE (STMSG) 


6 


150I 


LOGICAL PROCESS TABLE (LOG) 


7 


151 1 


LOGICAL PROCESS TABLE (LOAD) 


8 


152I 


LOGICAL PROCESS TABLE (IOMESSPROC) 


9 


1531 


LOGICAL PROCESS TABLE SYSIOPRDC 


10 








151*1 


LOGICAL PROCESS TABLE MEMLOGP 


11 


1551 


EXTERNAL PLABEL OF "TERMINATE" 
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reserved 

for 
logging 



156 



1 ST 



160 
161 
162 
163 

16k 
165 
166 
167 
170 
171 
172 
173 
17*+ 
175 
176 

177 
200 
201 
202 

203 
20U 

205 
206 
207 



INTERNAL PL ABEL OF "TERMINATE" 



EXTERNAL PLAEEL OF "OOMMANDINTERP" 
INTERNAL PLABEL OF "COMMANDINTERP" 



EXTERNAL PLABLE OF "SPOOLIN' 
INTERNAL PLABLE OF "TRACEO" 



EXTERNAL PLABEL OF "TRACEO" 
INTERNAL PLABEL OF "SPOOLIN" 



EXTERNAL PLABLE OF "SPOOLOUT" 
INTERNAL PLABEL OF "SPOOLOUT" 



3 WORD 
LOGGING 



MASK 
/////////// i STATE j DST# - BUFFER 



Hill I ill 1 1 1 STATE I DST# - BUFFER 1 
BUFFER LENGTH (SECTORS) 



STATE: 

EMPTY 

1 CUR 

2 FULL 



FREE AREA POINTER 
FLAGX 



# RECORDS WRITTEN IN BUFFER 

# RECORDS WRITTEN IN BUFFER 1 



FILE SIZE (BLOCKS) - 1ST HALF 






(LOG FILE SIZE) 






LOG FILE NUMBER (LOGFILENUM) 
NUMBER OF LOGGING [BLOCKS WRITTEN (1ST HALF)] 
BLOCKS WRITTEN [BLOCKS WRITTEN (2ND HALF)] 
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SYSTEM GLOBAL AREA (cont) 



octal 



name 



210 
211 
212 
logging 213 



21^ 

215 
216 

217 
220 



(TOTAL # LOG RECORDS MISSED) 
(DUE TO LOG FAILURE) 
TOTAL# RECORDS MISSED - "JOB INITIATION" LOSS 
TOTAL* RECORDS MISSED - "JOB TERMINATION" LOSS 
OPERATOR CONSOLE JOBSESSION # AT STARTUP 
GLOBAL 
ALLOW 
MASK 



LOADER 

MESSAGE 

TABLE 



250| 



I 

reserved 251 1 
for J 
segment 
trace 



252| 
I 
2531 
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1 

reserved 
for 

segment 
trace 

1 
i 


25UI 

255 1 

256 1 

2571 














1 

1 

I 






1 


260| 
26l| 
262| 
2631 
26U| 
2&5 1 
266 1 
2671 

270 i 
271 1 
2721 
273 1 

27U| 

2751 
276 1 

2771 

300| 
301 j 

302| 

303 i 




STMON 






MEASINFOTABPTR 




MEASUREMENT STATISTICS CLASS MASK 






CLASS STATISTICS BANK NUMBER 






CLASS STATISTICS ADDRESS 






SCAN POINT 






MEASFLAGS 






RESERVED 


1 
I 


Sysbase 


index of PCB at head of Dispatching Q 


1 

1 
1 


Sysbase 


index of PCB at tail of Dispatching Q 


1 

! 




RESERVED 


I 
1 




RESERVED 


R11SC 

1 

1 




RESERVED 


1 

1 

1 




HELP LOGICAL DEVICE NUMBER 


1 

1 




CURRENT LOGON DST 


1 
i 

1 




(STOP) 

(BITS) (see p. 2-15) 


1 

1 

1 




# PROCESS ENTRIES 


1 

i 
1 







GCLASSENABLEDMAS1 

MEASSTATXDSBANK 

MEASSTSTXDSBASE 



SYSDISQHEAD 
SYSDISPQTAIL 



DSTLOGON 
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process 

stop 

table 



30U 
305 
306 

307 
310 
311 
312 
313 
3lU 

315 
316 
317 
320 
321 
322 
323 
DS 32U 
325 
326 

327 
330 
331 
332 
333 
33** 



| DEVREC PIN | 


2 


1 %20 


i UCOP PIN | 





1 %20 


I LOG PIN | 


1 


1 %20 


1 IOMESS PIN | 


3 


I %20 


I MEMLOGP PIN | 


k 


i %20 


I RESERVED 


1 RESERVED 


I DSGL06AL DATA SEGMENT DST NUMBER 


| RESERVED FOR DS/3000 


(SET TO ZERO) 


I RESERVED FOR DS/3000 


(SET TO ZERO) 


I SDSLDEV PLABEL 


I RESERVED FOR DS/3000 


(SET TO ZERO) 


I RESERVED FOR DS/3000 


(SET TO ZERO) 


I RESERVED FOR DS/3000 


(SET TO ZERO) 


I RESERVED FOR DS/3000 


(SET TO ZERO) 


1 DISC STATUS 


[ LDEV ! 


DISC 


I AONESS 


I MAXQUEUE 


| DEFAULTQUEUE 



LAST 
DISC 
SIO 
ERROR 



JOBPRI 



1-lU 



3351 




DSCBECK PLABEL 




336| 
3371 




DSOPEN PLABEL 
DSCLOSE PLABEL 




3^0 1 




MANAGEWRITE CONV. PLABEL 




3*43.1 




CONSDSLINE' PLABEL 




3*+2| 




CXREMOTE PLABEL 




3^31 




CXDSLINE PLABEL 




31+UI 




CXRFA PLABEL 




31+51 




DSIMAGE PLABEL 




31+6 1 
31+71 


DEFAULT LABEL TYPE | TAPE LBL AUTO REC FUN 
SYSDB PTR TO TERM INIT CHNL PGM (S30/33 ONLY) 




350| 




|SD 


Softdeath 


35H 
352| 




LAST CYCLE DURATION 




3531 
35*+ 1 




CYCLE THRESHOLD 




3551 


BUG 


CATCH ENABLE CELL 




356| 


MONITOR BUFFER | TIMESTAMP 


MONBUFTO 


3571 


MONITOR BUFFER | TIMESTAMP 


MONBUFT1 


360 1 




DSBREAK PLABEL 




36l| 


Bank of 


Last memory word 


LAST MEMORY 


362 1 


Base of 


Last memory word 


ADDRESS 


/363I 

1 i 




PVPROC PIN 




|36U| 
Private < | 
Volumes I365I 

1 1 




PV RECOGNITION COUNT 




VMOUNT 


FLAGS | AUTO | ALL | ON 
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1366 

I 

1367 

\370 
371 
372 
373 
37** 
375 
376 

377 
1*00 









MSG CATALOG 


LDEV | 




MESSAGE CATALOG DISC ADDRESS 




MSG DSTN 


CONSMPLINE' PLABEL 


CONSMRJE PLABEL 


SYSTEM LEVEL UDC FLAG (1 = SYS UDC'S 


EXIST) 


SYSDB RELATIVE POINTER TO SYSGLOB EXTENSION 


CPU NUMBER 


( Set by the firmware ) 
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SYSGLOB EXTENSION (7.200 LONG; POINTER AT SYSDB+%377) 



% 0| 
I 



I 



Swap Queue Delay (*100ms) 



1| Bank of First Region in Linked Memory 

2-j Base of First Region in Linked Memory 
I— - 



Garbage Collection Enable Flag 



Move Threshold (in pages, for garb coll) 



5| Main Memory Page Size (in words) 

I- 

6| VDS PAGE SIZE 

I 

71 
J LAST MAKE ROOM TIME 

81 

I " 

91 MEMORY PRESSURE DURATION THRESHOLD 

I— - — 



SWAPQPELAY 

FIRST 

MEMORY 

REGION 

GARBCOLLENAB 

MOVETHRESH 
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57 
60 
6l 
62 
63 
6h 

65 
66 

67 
70 
71 
72 
73 
7U 
75 
76 
77 

100 
101 
102 



/////////////////////////////////////////////// 
PLABEL USERLOG (EXTERNAL) 
PLABEL USERLOG (INTERNAL) 



PLABEL RECLOG (EXTERNAL) 
PLABEL RECLOG (INTERNAL) 



PLABEL RESTART (EXTERNAL) 
PLABEL RESTART (INTERNAL) 



PMBC LOW CORE BANK # (USER) 
PMBC LOW CORE ADDRESS (USER) 



RESERVED FOR IMAGE $ S J~ of- Co***,, 

RESERVED FOR MEASIO 12 | MIOCNT 



lc c tf-* 7Vo / ^/»« * 



LOADER CACHE SEGMENT NUMBER 
PLABEL 3270 (EXTERNAL) 



MIT UPDATE 
MIT FIX 



MIT VERSION 
COUNT OF TAPE CONTROLLERS USING MEASIO 



PORT DATA SEGMENT NUMBER 



RESERVED FOR SECOND PORT DATA SEGMENT 
SYSTEM FPMAP OPTION FLAG 



SYSFPMAP 



* MIOCNT = MEASIOCOUNT (3 BITS) 
** MEASFLAGS (15:1) = 1 ==> MONITOR ENABLED 
(1U:1) = 1 ==> BUFFER FLIP/FLOP 
(13:1) = 1 ==> EOT ON MONITOR TAPE 
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SYSDB WORDS 



FUNCTION 

SYSDB relative pointer to BUSY TABLE for 

I/O resources 

SYSDB relative pointer to table containing 

head pointers to I/O resource queues 

SYSDB relative pointer to table containing 

head pointers to tail of I/O resource queues 

Number of I/O Programs currently executing 

0-no power fail 

1-system disc recovery 

2-all other disc recovery 

3-all other device recovery 

System is up and operable 

System console logical device number 



job synchronization via jobsynch (sysglob+121(8)) 



ADDRESS 


NAME 


DB+55 


BUSY 


DB+56 


HEAD 


DB+57 


TAIL 


DB+60 
DB+72 


SIO COUNT 
POWER FAIL 


DB+73 
DB+7U 


SYSUP 
CONSLDEVN 


JOBSYNCH 


job synchro 



(13:1) - JOBSREADY 



set by DEVREC & MORGUE (via procedure STARTDEVICE) 
indicating a ready job. This prevents UCOP from 
going to a wait state when a job is just made 
ready. 



(15:1) - DEVFREED - set by DEALLOCATE when device count goes to 0. 



NOTE - Both bits above used for synchronization of job -made -ready or 
devicefreed when UCOP is running. 



(1U:1) - JOBSWAITING- 



set by UCOP just before waiting if any job is 
waiting for list device. Signals DEALLOCATE to 
awake UCOP when a device is freed. 
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ALLOW MASK FORMAT 



WORD 1 



WORD 2 



WORD 3 



BIT 


COMMAND 





ABORTIO 


1 


ACCEPT 


2 


DOWN 


3 


GIVE 


1+ 


HEADOFF 


5 


HEADON 


6 


REFUSE 


7 


REPLY 


8 


STARTSPOOL 


9 


TAKE 


10 


UP 


11 


MPLINE 


12 


DSCONTROL 


13 


ABORTJOB 


1U 


ALLOW 


15 


ALTSPOOLFILE 





ALTJOB 


l 


BREAKJOB 


2 


DELETESPOOLFILE 


3 


DISALLOW 


k 


JOBFENCE 


5 


LIMIT 


6 


STOPSPOOL 


7 


SUSPENDSPOOL 


8 


OUTFENCE 


9 


RECALL 


10 


RESUMEJOB 


11 


RESUMESPOOL 


12 


STREAMS 


13 


CONSOLE 


lit 


WARN 


15 


WELCOME 





MON 


1 


MOFF 


2 


VMOUNT 


3 


LMOUNT 


U 


LDISMOUNT 


5 


MRJECONTROL 


6 


JOBSECURITY 


7 


DOWNLOAD 


8 


MIOENABLE 


9 


MIODISABLE 


10 


LOG 


11 


FOREIGN 


12 


IMLCONTROL 


13 


SHOWCOM 



1-20 



LOGGING RELATED LOCATIONS 



SYSDB 

1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 

172 j-j~i~!~i~!"l~!-!"l~i--l"!~i~!"! 

or | //////// | STATE | DST # | 

173 |_._.__. j 

STATE = if respective buffer empty 

1 if respective buffer is current 

2 if respective buffer is full 



FLAGX 



SYSDB 

1 2 3 U 5 6 7 8 9 10 11 12 13 lb 15 
,._|..|_-|..|..|..|-.|..|._|-|-|-|-| — I--I-I 
176 | //////////////////////////////// I SF | HF | BUF | SL | SD | 

I " — - " ""I 

SF = 1 if soft failure 

HF = 1 if hard failure 

BUF = if current log buffer is buffer 

= 1 if current log buffer is buffer 1 

SL = 1 to indicate a switch in log buffers (from to 1 or from 1 

to 0) 

SD = 1 to indicate shutdown in progress 
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PROCESS STOP LIST GENERAL LAYOUT 



SYSDB 



300 



31? 



STOP BITS REPRESENTING WHICH 
PROCESSES TO STOP ON "SHUTDOWN" 



# PROCESS ENTRIES 

/////////////////////////////////////////////// 
1ST PROCESS ENTRY 
2ND PROCESS ENTRY 



LAST PROCESS ENTRY 



ENTRY FORMAT 



1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 
PROCESS PIN # I STOP BIT # 
PROCESS WAIT STATE 



PREASSIGNED ENTRIES 



entry # process stop bit # 



1 devrec 2 

2 ucop 

3 log 1 
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Initial Memory Allocation 



This section is a description of the method used by INITIAL to allocate 
memory for MPE tables and code segments in MPE IV. All memory allocated 
by INITIAL is permanently allocated. All non-core resident code and 
data is put on disc before exiting INITIAL. 

At the most basic level INITIAL will try to build memory to look exactly 
as diagrammed below. There are, however, several ways in which to de- 
viate from this structure. Before going into the sources of these de- 
viations, it is necessary to point out which portions of memory are used 
by INITIAL during the restart and therefore cannot be used by MPE until 
INITIAL has finished. Before INITIAL begins to allocate any memory 
space, it relocates its core resident code, its code segment swapping 
area and its stack to the highest configured memory space. Addition- 
ally, it uses the last %2U0 words of bank on a series III and the last 
#326 words of bank on series 30, 33 and UU for its I/O buffer area and 
temporary code segment table. After INITIAL has built all of core res- 
ident MPE (tables and code), it builds the disc resident MPE tables. 
Since some of the disc resident tables may be too large to be built in 
INITIAL'S stack, these tables are built in unused memory space. There- 
fore, in addition to the memory space required for INITIAL'S code, 
INITIAL'S stack and core resident MPE, there must be enough space left 
in which to build the largest of the disc resident tables. 

INITIAL will essentially build memory in the order shown below, however, 
there may be an unused fragment of memory between the DRT's and the sys- 
tem global area which INITIAL will fill with the smaller tables. Nei- 
ther the tables marked with an asterisk nor the code segments will ever 
be put in this area. 

Beginning with the B MIT, all bank dependencies have been removed from 
core resident MPE code. If there is insufficient space in bank for 
any core resident code segment, INITIAL will put it into bank 1. At the 
present time core resident MPE is not large enough to occupy more than 
all of bank and part of bank 1. If the system being built by INITIAL 
is configured with 128K words or 160K words of memory then INITIAL'S 
stack will be in bank 1 (the code also on a 128K word memory size). If 
INITIAL is occupying part of bank 1 and the space is needed for a core 

— -—J j j_ wtyci 3. j. j.— V..-1J — JJ*a ...JJa^Ji j.«'U*1.k 4>U*.«* TMTrpT AT 

resiaeat nr& tuue segmcuu ui uu uuxxu a uxa^ jcaiucut wuic «u«i xuxxxnu 

will print the error message "ERROR #350 OUT OF MEMORY". 

Except for the exceptions stated above, for every allocation of memory 

TITTIDTIT JTn *» 1 i. J J —HI....— X ~. — _-_ _- .__J_.^«_ .__*h A .*. It^ X»«« «.«■« 4Ua TMWT1 * «. 

•LAxi-iAxi Klil l ll 5 1/ UJ'y IU auuraiiC euiy l cilia in xng a^iake usmcou kuc v»x s 

and SYSDB. It will then try the next available space in bank 0, then 
the next available space in bank 1. If it were necessary it could con- 
tinue searching until all all banks were checked for available space. 

Immediately before exiting INITIAL, INITIAL lays down all the memory 
region headers and trailers as shown below. For any one bank of memory 
there will only be one block of core resident MPE, regardless of its 
contents. The only block of core resident MPE that does not have a re- 
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served region global header is in bank 0. It does have the reserved 
region global trailer though. Before placing any code outside bank 
the first %23 words of every bank (except bank 0) is reserved for the 
region global header. 
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Initial Memory Layout 



//////////// BANK ////////////// 
Low Gore memory 
DRT 
System Global area 
Firmware area 
S7SGL0B Extension 
TBUF's 
*DIT's 
DST 
CST 
CSTX 
PCB 
ICS 
*IOQ 
Disc Request Table 

ILT/DLT 
I/O resource Table 
*System Buffers 

Swap Table 

CST Block Table 

Special Request Table 

Message Harbor Table 

Primary Message Table 

Measurement Information Table 

VDSMTAB 
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ARSMB Table 

Available Region List 

LPDT 

Timer Request Queue 

Job Process Count 

Job Cutoff Table 

Sir Table 

Memory Management Monitor Buffer 



Core Resident CST's in CST order 



Reserved Region Global Trailer 
Available Region Global Header 



Available Memory 



Available Region Global Trailer 

II I III I III I BANK 1 1 1 lllil II III 1 1 

Reserved Region Global Header 
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Core Resident CST's that didn't 
fit in BANK 



Reserved Region Global Trailer 
Available Region Global Header 



Available Memory 



Available Region Global Trailer 

IIIUIIIII BANK BOUNDRY ////////// 

Available Region Global Header 



Available Memory 



Available Region Global Trailer 

a m hi a bask boundry ////////// 

ETC. 
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CHAPTER 2 Memory Management Tables 



2,1 Segment Table Structure 

The current location and state of each data segment and loaded code segme 
is maintained in the segment table. This table is partitioned into three 
parts, as shown in Figure 2-1, The partitions are based on the segment 
classes: a segment is a data segment, a segment is a system si segment, 
segment is part of a program. The structure and format of each partition 
is described in the following. 



Overall ST Structure 



(%2),(%1002)+SYSBASE 



.> + + 



DST 



(%0) , (%1001)+SYSBASE 



• > + + 



CST 



CSTXMAP + 

(J11051) ~>| I I 

+- + I 

| I— -+ +- 

+ -+ I 



! 
! 

+- 

I 

+- 

I 

I 

+- 



! 



-+ 
I 



! 



+ + 

First 
| Loaded 
| Program | 

.>+ +< — (%3), current program pointer 

Next 
| Loaded 
! Program ! 
+ + 



*: JLg ui d c a. 
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2.1.1 Pointers and DST #'s of Segment Table Components 

i. DST 

% 2 absolute address of entry of the DST 
%1002 sysbase relative index of entry of DST 
DST# =2 

ii. CST 

% absolute address of entry of system si 
%1001 sysbase relative index of entry of system si 
%1032 displacement from DST base of entry of system si 
DST# =1 

iii. CSTX 

% 1 absolute address of entry of current program 
#1033 displacement from DST base to first CSTX entry si 

= fi CST (LAST) - € DST (0) = DFS 
DST# =U 

iv. CSTXHAP 

J&1051 sysbase relative index of entry of CSTXMAP 
DST# =U3 (%7D 
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2.1.2 Standard Segment Identifier Format 



SEGIDENTIFIER.(0:1) = 1 ==> SEG IS PART OF A PROGRAM 

==> (1:7) = PROGRAM INDEX INTO CSTXBLK, 
(8:8) = LOGICAL SEG NUMBER (0-63) 
SEGIDENTIFIER, (0:2) = ==> SEG IS A DATA SEGMENT, 

(2:lU) = DST ENTRY NUMBER 
SEGIDENTIFIER. (0:2) = 1 ==> SEG IS AN SL SEGMENT, 

(2:lH) = SL ENTRY NUMBER 
EQUATE SEGIDDATATYPE=0, 

2.1.3 DST Entry Formats 

DST Entry Format 

1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

Word 0|# OF CONFIGURED ENTRIES 

! 

Word 1 | ENTRY LENGTH 

| - 

Word 2|# OF AVAILABLE ENTRIES 



Word 3 I TABLE RELATIVE INDEX TO FIRST FREE ENTRY 



I 



DST General Entry Format 
Case (i) DST Entry for a Present Data Segment 
1 2 3 h 5 6 7 8 9 10 11 12 13 lU 15 

Word | A |0 |R | SIZE/U 

I — - 

Word 1 |D |R |I |S |M |F |S |C |W| 

|C JO |M JT |0 |W |Y JO |D| VMALLOC 
|V |C |I |K |D |I |S |R | | 
I I I I I IP I IE | | 



Word 2 | 
I 



BANK 



nacw 



FIRMINFO 
FLAGS 

MMBANK 
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Word 
Word 1 



Case (ii) DST Entry for an Absent Data Segment 

1 2 3 ** 5 6 7 8 9 10 11 12 13 lU 15 
A |0 |R | SIZE/U 



Word 2 
Word 3 



D |R |I |S |M |F |S |C |W| 

C JO JM JT JO |W JY JO JDJ 

V |C |I |K |D |I |S |R | | 

I I I I IP I IE | | 



VMALLOC 



L DEV # 



I 



HODA 



LODA 



FIRMINFO 



FLAGS 



HODA 
LODA 
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2.1.6 CST Entry Formats 

CST Entry Format 

1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 
|__|__|__|_.|„|__|_-|-_|-_|_-|--|-i-|-|--|" 

Word 0|# OF CONFIGURED ENTRIES 



I 

Word Ij ENTRY LENGTH 

I- 

Word 2|# OF AVAILABLE ENTRIES 



Word 31 TABLE RELATIVE INDEX TO FIRST FREE ENTRY 
I " 



CSTX ENtry Format 
1 2 3 h 5 6 7 8 9 10 11 12 13 lU 15 
Word [UNUSED 



I 



Word 1 UNUSED 



Word 2|# OF AVAILABLE ENTRIES 



I — 

Word 3 1 TABLE RELATIVE INDEX TO FIRST ENTRY 



CST General Entry Format 

Case (i) CST Entry for a Present SL Segment or CSTX Segment 



1 2 3 ^ 5 6 7 8 9 10 11 12 13 lU 15 
Word |A |M |R |T | SIZE/U 



■ — I — l — ■ — ■ — 1 - 

■ i i i 



I — - — 

Word 1 |/ |R |I |/ |/ |/ |S |C | IllilllUiUllilliUi 
1/ 10 |M |/ |/ | /|Y |0 \UIIIIUIIIIIIUIHIII 
|/|C|I|/|/|/|S|R |////////////////////// 
1/ I I 1/ 1/ 1/ I IE I////////////////////// 



Word 2 j 

i- 

Word 3 I 



BANK 
BASE 



FIRMINF0 
FLAGS 

MMBANK 
MMBASE 



case (ii) CST Entry for an Absent segment Sb or CSta segment 



1 2 3 ** 5 6 7 8 9 10 11 12 13 lU 15 

Word |A |M |R |T | SIZE/U 

I — 

Word 1 1/ |R |I 1/ 1/ 1/ IS |C | imiillUIIIIIIIIIII 
1/ 10 |M |/ |/ | /|Y |0 MiilliililHIIUillili 
1/ IC |I 1/ 1/ 1/ |S |R |////////////////////// 



FIRMINFO 



FLAGS 
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Word 2 
Word 3 



/I I 1/ 1/ 1/ I IE I////////////////////// 



L DEV # 



I 



HODA 



LODA 



HODA 
LODA 



2.1.7 CST Entry Field Descriptions 

A = 1 --> segment absent 

M = 1 ==> segment privileged 

R = 1 ==> segemnt has been referenced 

T = 1 ==> segment is being traced 
DCV = 1 ==> disc copy is valid 
STK = 1 ==> segment is a stack 

MOD = 1 ==> a segment modification (exp. , contr.) is pending 
FWIP= 1 ==> a forced write of this segment is in progress 
VMPAGECNT = # of virtual memory pages allocated to this segment 
ROC = 1 ==> segment is recoverable overlay candidate 
IMI = 1 ==> segment is in motion in 
S7S = 1 ==> segment is a system segment 
CORE= 1 ==> segment is core resident 
WD= 1 ==> write disabled 



TABLE FORMAT-CSTBLK 



CSTBLK(O)- 



* NUMBER OF ENTRIES IN TABLE 



1 * 

* ANY UNASSIGNED ENTRY = -1 * 

2 * 

* ANY ASSIGNED ENTRY > * 



* # 

* REMAINING CSTBLK TABLE ENTRIES * 



COMMENTS - 

The table is initialized to minus one in each entry. When selected, 
the entry is replaced by a DST-relative index into the CST extension 
block. 



2-6 



2.1.8 Program Blocks and the CSTXMAP 

Since programs can be dynamically loaded and unloaded, the segment table 
must be kept packed or fragmentation would occur Thus, the block of ST 
entries for a program segment begins at an ST entry number that changes 
if a program which was loaded before it gets unloaded. To manage this 
dynamic structure, an auxiliary structure, the CSTXMAP is used. A pro- 
gram is identified by its index, CSTXEIX, into this map. The program's 
current beginning physical ST entry number is equal to CSTXMAP 
(CSTXEIX) . 

ENTRY FORMAT-CST EXTENSION BLOCK 



CSTXMAP(CSTXEIX)-->-- 

* M = # OF CST'S IN BLOCK * 

1 * VALIDITY=%125252 * 

2 * # OF USERS SHARING BLOCK * 

3 * * 

%301 > * HAS CST ENTRY FORMAT * 

%302 > * HAS CST ENTRY FORMAT * 



%300+M > * HAS CST ENTRY FORMAT * 

COMMENT 

The value of CSTXEIX is established when a CST extension block is 
allocated. This index into the array CSTXMAP is maintained in the PCB 
of each process sharing the block. 
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2.1.9 
OCTAL 


Fixed DST Entry Assigni 


nents 
DECIMAL 


1 
2 

3 
1* 

5 
6 

7 

8 

9 

10 

li 

12 
13 

1U 

15 
16 

17 
18 

19 
20 


TABLE NAME 









1 


CST 


CST 


2 


DST 


DST 


3 


PCB 


PCB 


k 


CSTX 


CSTX 


5 


SYSTEM GLOBAL AREA 


SYS 


6 


CORE 


CORE 


7 


ICS 


ICS 


10 


SYSTEM BUFFERS 


SBUF 


11 


UCOP REQUEST QUEUE 


UCRQ 


12 


PROCESS-PROCESS 
COMMUNICATION TABLE 


PPCOM 


13 


I/O QUEUE 


IOQ 


1U 


TERMINAL BUFFERS 


TBUF 


15 


LOGICAL -PHYSICAL 
DEVICE TABLE 


LPDT 


16 


LOGICAL DEVICE 
AND CLASS TABLE 


LDT 


17 


DRIVER LINKAGE TABLE 


DLT 


20 


I/O RESOURCE TABLES 


BUSY, HEAD, TAIL 


21 


SECONDARY MSG TABLE 


SECMSGTAB 


22 


LOADER SEGMENT TABLE 


LST 


23 


TIMER REQUEST LIST 


TRL 


2U 


DIRECTORY 


DDS 
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DST ALLOCATION (CONT.) 







21 
22 
23 

2k 
25 
26 

27 
28 

29 
30 
31 
32 
33 
31+ 
35 
36 
37 
38 
39 

1+0 




25 




DIRECTORY SPACE 




26 


RIN TABLE 


RIN 


27 


SWAPTABLE 


SWAPTAS 


30 


JOB PROCESS COUNT 


JPCNT 


31 


JOB MASTER TABLE 


JMAT 


32 


TAPE LABEL 
TABLE 


VDD 


33 


LOG TABLE 


LOGTAB 


3U 


REPLY INFORMATION 
TABLE 


RIT 


35 


VOLUME TABLE 


VTAB 


36 


BREAKPOINT TABLE 


STOP 


37 


LOG BUFFER1 




ko 


LOG BUFFER2 




Ul 


LOG ID TABLE 


LIDTAB 


1*2 
H3 


ASSOCIATE TABLE 
CST BLOCK 


CSTBLK 


Vk 


JOB CUTOFF TABLE 


JCUT 


U5 


SYSTEM JIT 


SJIT 


U6 


SPECIAL REQ TABLE 


SRTTAB 


47 


VIRTUAL DISC SPACE 
MANAGEMENT TABLE 


VDSMTAB 


50 


iiiiiiuiiinmiuiii 




51 


ARSBM TABLE 


ARSBMTAB 
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DST ALLOCATION (CONT. ) 







U2 
1*3 

uu 

U5 
k6 

U7 
1+8 
1+9 
50 

51 
52 
53 
5U 
55 
56 
57 
58 
59 




52 


ILT 


ILT 


53 


SIR TABLE 


SIR 


5>» 


FMAVT 


FMAVT 


55 


INPUT DEVICE DIRECT 


IDD 


56 


OUTPUT DEVICE DIRECT 


ODD 


57 


WELCOME MESSAGE #1 


L0G0NDSTN1 


60 


WELCOME MESSAGE #2 


LOG0NDSTN2 


61 


CS DATA SEGMENT 


CSTAB 


62 


PROCESS -JOB 
CROSS REFERENCE 


PJXREF 


63 


SYSTEM JDT 


SYSJDT 


61+ 


COMMAND LOGON DST 


CILOGDST 


65 


MOUNTED VOL. SET TABLE 


MVTAB 


66 


PRI.VOL. USER TABLE 


PVUSER 


61 


AVAILABLE REGION LIST 


ARLDTAB 


70 


DISC REQUEST TABLE 


DISCREQTAB 


71 


MSG HARBOR TABLE 


MSGHARBTAB 


72 


PRIMARY MESSAGE TABLE 


PRIMMSGTAB 


73 


MEASUREMENT INFO TABLE 


MEASINFOTAB 








71* 


FIRST FREE DST 


60 
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2.2 Swap Tables 
2.2.1 SWAPTAB 



The Swaptab is a core resident memory management table used to 
keep track of the locality lists of the competing processes. 

SWAPTAB DST# = 23 (Jl27) 

%1025 Sysbase relative index of SWAPTAB entry 0. 



ep 



SWAPTAB ENTRY FORMAT 

1 2 3 U 5 6 7 8 9 10 11 12 13 l 1 * 15 

I- 
SWAPTABOOl 

I 
SWAPTAB01 | 

I 
SWAPTAB02 | 

I 
SWAPTAB03 I 

I 
SWAPTABOUI 



# ENTRIES CONFIGURED 


ENTRY SIZE (5) 


# FREE ENTRIES 


TABLE 


RELATIVE INDEX OF FIRST 


FREE 


ENTRY 












SWAPTAB00 
SWAPTAB01 
SWAPTAB02 
SWAPTAB03 
SWAPTABOlt 



SWAPTAB UNASSIGNED ENTRY FORMAT 

1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 
■I--I--I--I--I--I--I--I--I--I--I--I-I--I--I-- 

?liooooo 



TABLE RELATIVE INDEX OF NEXT FREE ENTRY 






I 



An assigned entry in the swaptab is a process' SLL header or a 
member of a process' SLL. These formats are now described. 
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2.2.2 Segment Locality Lists (SLL) 

The system maintains for each process a segment locality list 

(SLL) of 

the segments belonging to that process' current working set. The 

process' SLL consists of a header and a list of entries. 

The header and list entries are taken from the SWAPTAB. 

A process' SLL is located via the process' pcbentry. PCB01 
contains the sysbase relative index of the process* SLL header. 



SWAPTAB 



PCB01--> 
+ -- 



+-> 
+-- 



SLLHEADER 



FIRST SLL ENTRY 



NEXT SLL ENTRY 
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SLL HEADER FORMAT 



1 2 3 h 5 6 7 8 9 10 11 12 13 lit 15 

|S |S |H il |P iS i | i 

W |W |A |N |A |T | | 

SLLHEADOOlI jR js |T |R |R | | IOCNT 

P JE JM |L |T |T J | 

IQ IE |0 |I |0 | i 

I IN |C |N |V | | 



SLLHEAD01 
SLLHEAD02 
SLLHEAD03 
SLLHEADOU 



SYSBASE RELATIVE INDEX OF FIRST ENTRY IN LIST 

WORD NOT CURRENTLY USED 
SYSBASE RELATIVE INDEX OF MEMORY REQUEST ENTRY 
# ENTRIES IN PROCESS' SLL 



SLL 

SCHEDTOIOMSG 



SLLFIRSTINX 

SLLMEMREQINX 
SLLCOUNT 



SLLHEADOO .(0:1) SWIP, Swap In Progress Flag 
.(1:1) SWREQ, Swap Required Flag 
.(2:1) HASMEM, Has Memory Flag 
.(3:1) INTLOC, Initialize locality list 
.(U:l) PARTIN, Process partially swapped in 
(5:1) STRTOV, Start swap over flag 
Available 
IOCNT, Segment read completions until awake 



(6:2) 
(8:8) 
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SLL ENTRY FORMAT 

l 2 3 ^ 5 6 7 8 9 10 11 12 13 lU 15 

SLLENTRY00| PMPQPIN | NMPQPIN 

I — 

SLLENTRY01| SYSBASE RELATIVE INDEX OF NEXT ENTRY IN LIST 

I 

SLLENTRY02| SYSBASE RELATIVE INDEX OF PREV ENTRY IN LIST 
| 

SLLENTRY03I SEGIDENTIFIER 

I 

SLLENTRYOUI/ |S |/ |/ |/ |/ |/ |T |F |L |S|D| //////////// 

1/ IT 1/ 1/ 1/ 1/ 1/ |0 |Z |K |L| I | //////////// 

1/ IK 1/ 1/ 1/ 1/ 1/ |S |R |R | L| S| llllllllllll 

1/ I 1/ 1/ 1/ 1/ 1/ IS |E |E | I |C | llllllllllll 

1/ I 1/ 1/ 1/ 1/ 1/ I IQ IQ |M| I | llllllllllll 

1/ I 1/ 1/ 1/ 1/ 1/ I I I Hlo| llllllllllll 



SLLMPQLINK 

SLLNEXTINX 

SLLPREVINX 

SLLSEGIDENT 

SLLFLAGS 



SLLENTRY00 .(0:8) PMPQPIN, previous make present deferred queue pin 
.(8:8) NMPQPIN, next make present deferred queue pin 

SLLENTRY01 .(0:l6) SYSBASE, relative index of next entry in list (=0=> 

last entry) 

SLLENTRY02 . (0:l6) SYSBASE relative index of previous entry in list 

(=0==> first entry) 

SLLENTRY03 Has standard segment identifier format. 

SLLENTRYOU .(1:1) STK ==> process' stack entry 
.(7:1) TOSS ==> Toss this entry 

.(8:1) FRZREQ ==> Process requests a freeze on seg 
.(9:1) LKREQ ==> Process requests a lock on seg 
. (10:1) SLLIMI ==> process is queued for this segment 
.(11:1) DISIOSEG ==> process waiting for disc i/o against 

this seg 
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SPECIAL REQUEST TABLE 



(USED FOR PASSING DATA SEGMENT SIZE CHANGE INFO AND FOR KEEPING 
A LIST OF DEVICES WAITING FOR A SEGMENT TO ARRIVE IN MEMORY.) 



ENTRY 
1 
2 
3 
k 



first 

assigned 
entry 
(pointed 
to by 
%10U3) 



>0 



# entries in table 



entry size (5) 

# available entries 



first available entry 
last available entry 



next assigned entry 



segidentifier 

new data seg size 



read displacement 
move count 
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2.3 Main Memory Region Headers and Trailers 



Main memory is partitioned into regions. Each region is in one of 
three states: available, reserved, or assigned. 

An available region is available for consumption by the free space allo- 
cation mechanism. An available region consists of neighboring subre- 
gions, each of which is either a hole or an overlay candidate. An 
available region is linked into the available region list of appropriate 
size. 

A reserved region is a main memory region which is in the transition 
state from available to assigned. A reserved region has been cleaned, 
and there is a pending disc read of a segment into the region. 

Assigned regions are occupied by present segments. Available and re- 
served regions consist of one or more adjacent subregions. Region 
headers and trailers are partitioned into global and local components. 
The global region header/trailer is only valid for the first/last sub- 
region in regions consisting of more than one subregion. 

ijij^g ^^g^Qj^ headers and trailers of available, reserved, and assxgned 
regions contain the state and control information pertaining to the 
current or planned contents of the region. 
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2.3.1 Available Region Headers and Trailers 



Available Region Global Header Format 
(only valid for first subregion) 



RB-19 

RB-18 

RB-17 

RB-16 

RB-15 
RB-lU 

RB-13 
RB-12 

RB-11 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

■ ■■•■■•iitllll 

. I _. I __!__,__,__ 1 — j — j — 1 — J — 1--1-- 1 — 1 

A |R 
S |E 
S |S 



A |C |R |R |R |R I //////////////////// I R 

V jL |E iE iE jE I //////////////////// IB 

IN |s |s |s |s I IIIHIIUIIIIilimi IS 

ID I I I I I //////////////////// I 



REGION SIZE 


(IN MAIN MEMORY PAGES) 


RESERVED 


RESERVED 


REGION BASE OF 
REGION LIST 


PREVIOUS IN THIS AVAILABLE 


REGION BASE OF 
REGION LIST 


NEXT IN THIS AVAILABLE 


RESERVED 



Available Region Subregion Header 
(Valid for All Subregions) 



RAS 



RS 



PLINK 



NLINK 



RB-10 

RB-9 

RB-8 

RB-7 

RB-6 

RB-5 

RB-U 

RB-3 

RB-2 

RB-1 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 



l__l_.l..l_.l_-l-.l-.l._l__l--l-l. 



SUBREGION SIZE (IN MAIN MEMORY PAGES) 



V I SUBREGION DISPLACEMENT (IN MAIN MEM PAGES) 



WRITE REQUEST POINTER 



SEGMENT IDENTIFIER 



RESERVED 



RESERVED 



LDEV # 



HODA 



LOW ORDER DISC ADDRESS 



/////////////////////////////////////////////// 
/////////////////////////////////////////////// 



ss 

SD 

WREQP 

SEGIDET 



HODA 
LODA 
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Available Region Subregion Trailer 

l 2 3 ** 5 6 7 8 9 10 11 12 13 lU 15 



///////////////////////////////////////////////I 
- - I 

SUBREGION SIZE | TSS 

- I 

Available Region Global Trailer 
(Valid Only for Last Subregion) 

1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
|„|-_|--|-_|--|--|--|--|-_|-|--|-|-_|-|-|_-| 

|A |R |A | lilUIIIIIUIIIIIIiillllllllllllllllll I TRAS 
IS |E |V | ////////////////////////////////////// I 
IS |S | | ////////////////////////////////////// I 

I I 

| REGION SIZE | TRS 
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2.3*2 Reserved Region Headers and Trailers 

Reserved Region Global Header Format 
(Only Valid for First Subregion) 



RB-19 

RB-18 
RB-17 

RB-16 



RB-15 



RB-lU 



RB-13 
RB-12 
RB-11 



c 


1 1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
1 i__i__| i__j__j |__|__|__| |__|__j__|__| 


iA 

is 


|R jA |C |S |L |F |I I //////////////////// |M j 
|E |V |L |C |K |Z |0 | //////////////////// II I 
|S | |N | |D |N |F | //////////////////// |P ! 
1 1 ID | | | |Z I////////////////////I 1 


1 REGION SIZE (IN MAIN MEMORY PAGES) | 


I ON-GOING I/O COUNT | 


|M 

|S 
|G 

IP 
|R 

io 

|c 


|E |0 |Q |I |E |G |M |R| //////////////////IM | 

|X |N |S |N |X |A |S |E| //////////////////|S | 

IT JG |E |C |P |R |G |L|//////////////////|G | 
|D |I |G |M |R |B |A I R 1 ////////////////// 1 V | 
|I |0 |R |V |R |C |B |E | ////////////////// 1 A | 

|S |D |E | |E |0 |0 |S|//////////////////|L | 
| |I |A | |Q |L |R IPI//////////////////U I 
| |S | | | |L |T |G|//////////////////|D | 


| INITIATION MESSAGE INFORMATION | 


|M 

is 

JG 
IP 
|R 
|0 

|c 


|M|B|S|I|M|/|/ \i mm mini III inn 1 

|0 |K |C |0 |S |/ |/ | | 
|D |D |H |W |G |/ |/ I ! 
|R |L |E |A |A 1/ 1/ | | 
|E |E |D |I |B 1/ |/ | | 
|Q | |H |T 10 |/ |/ | 1 
1 1 IS | |R 1/ 1/ | | 
1 1 |G | |T |/ |/ | | 


| PIN OF FIRST PROCESS | PIN OF LAST PROCESS | 


| RELEASE PAGE COUNT | 


1 SPECIAL REQUEST TABLE POINTER | 



RAS 

RS 

IOCNT 

INITMSG 



INITINFO 



COMPMSG 



MPQLINK 
PAGECNT 
SPECREQTABPTR 
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RB-10 



RB-9 



RB-8 
RB-7 
RB-6 
RB-5 
RB-U 
RB-3 
RB-2 
RB-1 



Reserved Region Subregion Header 
(Valid for all Subregions) 



l 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 



|..|..|._|..|.-|-|-|._|-|-|-|-|-|--| 



SUBREGION SIZE (IN MAIN MEMORY PAGES) 



# PAGES THIS SUBREGION IS DISPLACED 
FROM THE REGION BASE 



WRITE REQUEST TO POINTER 
SUBSEGMENT IDENTIFIER 



FREEZE COUNT I LOCK COUNT 
WRITE DISABLED COUNT | I/O FROZEN COUNT 



LDEV # | HIGH ORDER DA 
LOW ORDER DISC ADDRESS 



/////////////////////////////////////////////// 
/////////////////////////////////////////////// 



HB —> First Word of Segment 

Reserved Region Subregion Trailer 
(Valid for All Subregions) 



1 2 3 1* 5 6 7 8 9 10 11 12 13 lfc 15 



SS 
SD 



WREQP 

SEGIDENT 

LKFZCNTRS 

WDIOFZCNT 

HODA 

LODA 



.|„|__|„|__|__|._|--|-|~|-|»|"l"l"l"l 
///////////////////////////////////////////////I 



SUBREGION SIZE (IN MAIN MEMORY PAGES) 



TSS 
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Reserved Region Global Trailer 
(Valid Only for Last Subregion) 



1 2 3 U 5 6 7 8 9 10 11 12 13 14 15 

|A |R |A | ////////////////////////////////////// I 

IS |E |V | ////////////////////////////////////// I TRAS 

IS |S | | ////////////////////////////////////// I 

I — - I 

| REGION SIZE (IN MAIN MEMORY PAGES) | TRS 

I I 
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2.3*3 Assigned Region Headers and trailers 

Assigned Region Global Header Format 
1 2 3 U 5 6 7 8 9 10 11 12 13 lb 15 



RB-19 



RB-18 
RB-17 
RB-16 
RB-15 
RB-lU 
RB-13 
RB-12 
RB-11 



A |R 
S |E 

S js 

I 



|S |L |F |I I////////////////////IM 

| C |K | Z |0 I //////////////////// 1 1 

I IP IN |F I //////////////////// |P 

Z I //////////////////// I 

N I //////////////////// I 



|C 
|L 
IN 

ID I I I ! 

I I I I I 



REGION SIZE (IN MAIN MEMORY PAGES) 



RESERVED 



RESERVED 



RESERVED 
RESERVED 



RESERVED 
RESERVED 
RESERVED 



RAS 



RS 



Assigned Region Subregion Header 



RB-10 

RB-9 

RB-8 

RB-7 

RB-6 

RB-5 

RB-U 

RB-3 

RB-2 

RB-1 



1 2 3 b 5 6 7 8 9 10 11 12 13 1U 15 
SUB-REGION SIZE 

RESERVED 



RESERVED 
SEGMENT IDENTIFIER 



FREEZE COUNT | LOCK COUNT 
WRITE DISABLED COUNT | I/O FROZEN COUNT 



LDEV# | HODA 

LOW ORDER DISC ADDRESS 



/////////////////////////////////////////////// 
/////////////////////////////////////////////// 



ss 



SEGIDENT 
LKFZCNTRS 
WDIOFZCNT 
HODA 
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RB==> 

Assigned Region Subregion Trailer Format 



1 2 3 U 5 6 7 8 9 10 11 12 13 l 1 * 15 
/////////////////////////////////////////////// 



SUBREGION SIZE 



TSS 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

l_.l._l..l_.l„l-.l_.l..l.-l..l-l__l_.l-.l.-l..l 

|A |R |A | IllllUlllllllllllilllllilllllllllllll I TSS 
IS |E |V | ////////////////////////////////////// I 
IS |S | | ////////////////////////////////////// I 

I I 

j REGION SIZE (IN MAIN MEMORY PAGES) | TRS 

I " 1 
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2.3.*+ Region Header and Trailer Field Descriptions 



RAS, 



IOCNT, 



INITMSG, 



INITIHFO, 



COMPMSG, 



Region Assignment State 
.(0:1) Region Assigned Flag 
.(1:1) Region Reserved Flag 
.(2:1) Region Available Flag 
.(3:1) Region Cleaned Flag 
.(U:l) Size Change Pending Flag 
.(5:1) Region Locked Flag 
.(6:1) Region Frozen Flag 
.(7:1) Region I/O Frozen Flag 
.(8:7) Available 

.(15:1) Blocked Lock Migration in Progress Flag 
On-Going I/O Count 

= # of on-going 1/0's in the region which must complete 
before the initiation message can be processed. 

Initiation Message 

0:1) Message Processed Toggle Switch 

1:1) Message Externally Disabled Flag 

2:1) Message On-going I/O Disabled Flag 

3:1) Queue Segment Read Disc Request Flag 

k:l) Incore Move Request Flag 

5:1) Expansion Request Flag 

6:1) Garbage Collection Flag 

7:1) Message Aborted Flag 

8:1) Release Residual Pages Flag 

9:6) Available 
.(15:1) Message Valid Flag 
Initaition Message Auxiliary Information 
= Sysbase relative index of segment read disc request if 
INITMSG, QREADREQ=1 

or 
= +/- Displacement to initiation message for moves and 
expans ions . 
Completion Message 



(0:1 
(1:1 
(2:1 
(3:1 
(i+:l 

(5 = 1 
(6:2 



Message Processed Toggle Switch 

Segment Modification Required 

Block Lock Request 

Send Scheduler A Message 

Awaken A Device 

Message Aborted 

Available 
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MPQLINK, Make Present Deferred Queue Link 

.(0:8) PIN Of First Process Waiting for this Segment 
.(8:8) PIN of Last Process Waiting for this Segment 
PAGECNT, Release Page Count 

=# of extra pages to release before processing initiation 
message. 
SPECREQTABPTR , points into special request table to the list of 

devices queried on this segment. 
SS, Subregion Size 
SD, Subregion Displacement 

.(0:1) Displacement Count Valid Flag 
.(1:15) # Pages to Base of Region 
WREQP, Write Request Pointer 

= Sysbase Relative Index of Disc Write Request when the 
Data Segment in the Subregion is in Motion Out 
SEGIDENT, Segment Identifier- has standard segment identifier format 
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Space Allocation Structures 



Available regions in main memory are kept track of by multiple free 
lists. All available regions of the same size are linked 
into the same available region list (ARL). A bitmap is 
maintained to indicate which lists are non-empty (ARSBM). A sys- 
glob cell is maintained which contains the size of the largest cur- 
rently available region. #10U5 MAXAVAILREG, number of pages in 
largest currently available region. 

Available Region List (ARL) 



%10UU SYSBASE index of base of ARL 
ARL DST # = 55 (%6?) 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 



ARLD(O) 



ARLD(l) 



ARLD(2) 









BANK 


OF FIRST AVAIL REGION OF SIZE = 1 PAGE 


BASE 


OF FIRST AVAIL REGION OF SIZE = 1 PAGE 


BANE 


OF FIRST AVAIL REGION OF SIZE = 2 PAGES 


BASE 


OF FIRST AVAIL REGION OF SIZE = 2 PAGES 



ARLD(N) 



BANK OF FIRST AVAIL REGION OF SIZE = N PAGES 



BASE OF FIRST AVAIL REGION OF SIZE = N PAGES 



Where N = maximum available region size 
_ (2**l6/2**pagepower) pages 
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Available Region Size Bit Map (ARSBM) 

fcLOOl* SYSBASE index of base of ARSBM 

ARSBM DST# = kl (%51) 

1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

ARSBM(O) | | | | I I I I I I I I I I I I I 

I ""I 

I I I I I I I I I I I I I I I I I 
I -——I 



ARSBM(M) | | | | I I I I I I I I I I I I I 



M = (# of available region sizes/l6) +1 

ARSBM (J) . (K:l) =1 ==> the available region list of 

size J*l6+K Pages is non-empty. 
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CHAPTER 3 DISC LAYOUT 



SYSTEM DISC LAYOUT 



SECTOR # 
% 0| 

H 



31 
h\ 
51 
61 
71 
10 1 
111 



DISC LABEL 



SECTOR # 
— + 

10 



Defective Tracks Table or 
Defective Sector Table 



Cold Load Channel Program for /3X, AX, /6X 
and for discs on Series III HPIB adapter 



Hem Dump Channel Program for /3X, AX, /6X 
Reserved Area Bit Map 



CODE FOR 
INITIAL PROGRAMS 
"BOOTSTRAP" 
SEGMENT 



LOW CORE (CST POINTER, QI, ZI , POINTER) 



TEMPORARY CST (INITIAL PROGRAM) 
Initial's ININ 



BOOTSTRAP STACK 



remainder of SIO cold load program or 
cold load channel program 



3 

U \ 
5 
6 



> Variable 
Length 



Follows 

immediately 

after 

Bootstrap 

Segment 
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SYSTEM DISC LAYOUT (CONT.) 



SECTOR # 
% 



3U 
35 



DISC COLD LOAD INFORMATION TABLE 



DISC COLD LOAD INFORMATION TABLE 



I SECTOR # 



|28 
129 
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SYSTEM DISC LAYOUT (CONT. ) 



SYSDB 



%130/131 



SYSTEM DIRECTORY 



VIRTUAL MEMORY AREA 



INITIAL PROGRAM SEGMENTS 
(EXCEPT BOOTSTRAP SEG) 



SYSTEM FILES 
(FROM COLD LOAD TAPE) 



SYSTEM TABLES 

* LPDT 

* LDT 

* VOLUME TABLE 

* DEVICE CLASS TABLE 
INITIAL PROGRAM STACK 



USER FILES 



Note: Initial 
tries to allocate 
directly after 
the Free Space 
Map. However, 
this may vary 
depending on 
deleted or 
reassigned tracks 
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DISC LABEL (Sector of disc) 



SYSTEM VOLUME 
1 2 3 1» 5 6 7 8 9 10 11 12 13 lU 15 



o| 

I 

II 
I 

2| 
I 

31 
I 

M 

I 

51 
I 

61 
I 

71 

I 

10| 

I 

111 

I 

12 1 

I 
131 

I 
1UI 

I 
151 

I 
161 



CONTROL ORDER 
«CYL/ARC #» 


READ ORDER 
«MEM ADDRESS » 


SIO JUMP ORDER 
<<MEM ADDRESS >> 


/////////////////I DISK TYPE 


IDISKSUBTYPE 


COLD LOAD ID 


"3" 1 


"0" 


"0" | 


"0" 



VOLUME NAME 



DISC BOOTSTRAP 
SIO PROGRAM 
(SYSTEM DISC 
ONLY) 

Words 0-5 contain the 
Ascii string 
"SYSTEM DISC" for 
/3X, AX, /6X 
(system disc only) 



1 
2 
3 

5 
6 

7 
8 

9 If word (%11) 
contains a "1" 

10 a former system 
volume has been 

11 scratched. 

12 

13 



UNUSED 



2U| 
I 

251 
I 

26| 

I 
271 



HEAD 



CYL 



SECTOR 



ICF WCS 

IMAGE 
POINTER 



122| 



RESERVED 



3-U 



I 

123 1 CYL 

I 

12U| HEAD I SECTOR 



I 



170 
171 
172 
173 
17U 

175 
176 
177 



1 120 

Disc Free Space map OK flag |121 

Disc Free Space map descriptor table checksum | 122 

Disc Free Space descriptor table dirty flag | 123 

jl2U 
— Disc Free Space descriptor table address -- 

125 



|126 
Disc Free Space bitmap address 

!127 
I 
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DISC LABEL SECTOR (CONT. ) 



SERIAL VOLUME 




1 
2 
3 
U 

5 
6 

7 

10 

11 

12 
13 
ll» 

15 
16 

17 
20 
21 
22 
23 
2U 

25 
26 



(:STORE) 



or 



Cold-load SIO channel program (non-HPIB 
machines only). For HPIB machines, cold 
load channel program is in sector 2 and 
SOFTDUMP channel program is in sector 3. 

111111 
0l23U567890l23»+5 



SC|HV|SR| 



| TYPE 



| SUB-TYPE 



"S" 


1 




"E" 




M R" 


1 




"D" 




"I" 


1 




"S" 




"C 


1 




II II 




Words Per Sector 


Sectors Per Track 


(Cartridge tape =1) 




Sector Address of 


Beginning 


of 


Tape (BOT) 




Double Address of 
End Of Tape (EOT) 








- 



Double Address of 
End Of Data (EOD) 



CYL 



HEAD 



SECTOR 




1 
2 
3 
U 

5 
6 
7 
8 

9 

10 

11 

12 

13 

lit 

15 
16 

17 
18 

19 
20 
21 

22 



SC = 1 ==> 

Scratch volume 
MV = 1 ==> Master 

Volume of PV set. 
SR ■ 1 ==> 

Serial disc 



VOL NAME 
"SERDISC " 



Serial 
> Disc 
Info 



/ 

ICF WCS 

IMAGE 
POINTER 
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Serial volume (continued) 



271 1 23 

» • 

RESERVED FOR FUTURE WCS 
122j !82 

I " " " I 

1231 CYL |83 

I I 

12*t| HEAD | SECTOR \6k 
I I 
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DISC LABEL (cont) 



SECTOR 



MASTER VOLUME 




1 
2 

3 
U 

5 

SC = SCRATCH 6 

VOLUME 
MV = MASTER 7 

VOLUME = 1 
SR = SERIAL 10 
VOLUME 11 

12 

13 
11* 

15 
16 

17 

20 

21 
22 
23 
2k 

25 
26 

27 
30 



SC|MV|SR| |6 TYPE 11|12 SUB-TYPE 15 
GENERATION INDEX 




VOLUME 
NAME 



INITIAL DATE 
DIRBASE 
DIRSIZE 



ACCOUNT 
NAME 



GROUP 
NAME 



8 
9 

10 
11 
12 
13 

lit 

15 IF NOT 
MASTER 

16 VOLUME 

17 
18 

19 
20 

21 
22 
23 
2U 



3-8 



MASTER VOLUME (CONT.) 



3H 
32 1 
331 
3k\ 



VOLUME SET 
NAME 



35! 



VS VTAB 

HEADER + —— — — — — 

8 ENTRIES 36 1 VCOUNT 3 1 
COPIED FROM 

VSET DEFN 371 

IN SYSTEM Uoj 

DIRECTORY Ul | 

U2| 



U3I 

kk I SUB-TYPE 



U5\ 

I 



116 1 



VOLUME 
NAME 



VMASK 



VTABX 



125 

126 

1 27 HEADER 

I 28 



|29 
130 



131 

132 

1 33 VOLUME 

|3U ENTRY 



135 
136 



137 

I 



178 



VOLUME 

ENTRY 

7 



170 
171 
172 
173 
17U 

176 

177 



Disc Free Space map OK flag 
Disc Free Space descriptor table checksum 



Finer* TTffio SS"r*ar*o HocnriT^+nr +aV\1 a A^-r+ir "PI a cr 

— ~— — --— — _£.___ ___,,. _£,..._ ..._—_ __. , rf . — -O 



Disc Free Space descriptor table address 



Disc Free Space bitmap address 



1 120 

1 121 
|122 
|123 
|12l* 
|125 

1126 
1 127 
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DISC LABEL (cont) 



SECTOR 



SLAVE VOLUME 













o| 




|0 




1 




jl 




2 





|2 




31 




13 




*»l 






SC = SCRATCH 


51 






VOLUME 
MV = MASTER 








6 | SC | MV | SR | 


|6 TYPE 11| 12 SUB-TYPE 


1516 


VOLUME = 
SR = SERIAL 








71 


GENERATION INDEX 


17 


VOLUME 








10 1 





18 




111 




19 




12 1 




|10 




131 


VOLUME 


111 




1U| 


NAME 


|12 




151 




113 




16 1 


INITIAL DATE 


111* 




171 





U5 




20 1 




116 




21 1 




U7 




22 j 


ACCOUNT 


U8 




231 


NAME 


U9 




2\\ 




| 20 




251 




I 21 




26| 


GROUP 


j 22 




271 


NAME 


|23 




30| 




|2l+ 




31 1 




125 




32 1 


VOLUME SET 


|26 




331 


NAME 


127 




3U| 




|28 
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170 
171 
172 

173 
17k 

175 
176 
177 



Disc Free Space map OK flag 

Disc Free Space descriptor table checksum 

Disc Free Space descriptor table dirty flag 

-- Disc Free Space descriptor table address - 



Disc Free Space bitmap address 



120 
121 
122 
123 
12l< 

125 
126 

127 
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DEFECTIVE TRACKS TABLE (DTT -- Sector 1 of Disc) 
(the DTT exists on device type 0, 1, & 2 discs) 



1 2 3 *» 5 6 7 8 9 10 11 12 13 lit 15 





1 
2 
3 

5 
6 

7 
10 
11 
12 



# OF DEFECTIVE TRACK ENTRIES 


-1- 
(N) 


I--I" 


DEFECTIVE TRACK NUMBER 




| DTC 


DEFECTIVE TRACK NUMBER 




| DTC 


DEFECTIVE TRACK NUMBER 




| DTC 


DEFECTIVE TRACK NUMBER 




| DTC 



165 
166 
167 




1 
2 
3 
U 

5 
6 

7 
8 

9 

10 



DEFECTIVE TRACK NUMBER 


| DTC 


DEFECTIVE TRACK NUMBER 


| DTC 


DEFECTIVE TRACK NUMBER 


| DTC 



117 
118 
119 



120 DEFECTIVE 
TRACKS MAXIMUM 
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DEFECTIVE TRACKS TABLE (CONT.) 



170| 

I- 
171 1 

I 
172| 

I 
1731 

I 
17M 

I 
1751 

I 
1761 

I 
1771 



DEFECTIVE TRACK NUMBER 



RESERVED FOR 
FUTURE USE 



NEXT AVAILABLE ALTERNATE TRACK 



LOGICAL DISC PACK SIZE (CYLINDERS) 



OR # OF TRACKS IF FH DISC 



DTC 


(DEFECTIVE TRACK CODE) 





suspect 


1 


suspect alternate 


2 


deleted 


3 


reassigned 



DTC 



120 
121 
122 
123 
12U 

125 
126 

127 



NOTE: The situation where there are two entries for the same 
track, n, one having a DTC of (suspect) and the other having 
a DTC 3 (reassigned) results from a situation where the disc 
driver could not "read" (unreadable) the address of the 
particular track. 



3-13 



DEFECTIVE SECTOR TABLE (DSCT -- sector 1 of disc) 
(the DSCT exists on device type 3 (CS/80) discs) 



1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 
number of entries in the table 



%1 
%2 
543 

%5 
%6 

%10 

*12 



index to the first entry (6) 



entry size (2) 
maximum number of entries (6l) 



(reserved) 
(reserved) 



first defective sector entry 
(double-word logical sector address) 



second entry 



third entry 



1 
2 

3 
k 

5 
6 

8 

10 



I 

I 

7.176 I 

%177 I 



maximum defective sector entry 



I 

| 126 

I 127 



Unlike the DTT, entries in the DSCT are not permanent. 
Once a suspect sector is handled by INITIAL or VINIT, 
its entry is removed from the table. Thus this table 
contains only unprocessed suspect sectors. 
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RESERVED AREA BIT HAP (sector U of the system disc) 



The first i»00 sectors of the system disc are reserved for Initial's 
use. This area contains permanent data structures for the boot. 
It is also used as a temporary storage area for data during 
sparing. All other system volumes and private volumes reserve 
only the first 10 sectors of the disc. They do not have a 
reserved area bit map. 

The bit map contains 1 bit per sector. A *1* means the sector 
is free. 

+ — + 

%0 | 10 

I I 

I reserved area 1 



bit map 



I ! , 

%30 | I 2U 

I 1 

%3l I I 25 

| reserved for ! 

j future use I 

I I 



&177 I I 127 

+ + 
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DISC COLD LOAD INFORMATION TABLE (SECTORS 28-29) 















o| 




pointer to table informat 


ion 








11 




pointer to temporary CST 


info 




TCSTPTR | 


2| 


# 


of entries to read on disc 


cold 


load 


NREAD ! 


31 


# 


of code segments in INITIAL 




NVTCST' j 


U| 




INITIAL'S DB value 






INITDB | 


51 




INITIAL'S DL value 






INITDL | 


61 




INITIAL'S Z value 






INITZ i 


71 




INITIAL'S Q value 






INITQ | 


8| 




INITIAL'S S value 






INITS | 


9\ 




| SYSDISC type | 


subtype 


DISCTST j 


10 1 




cold load ID 






COLD 'LOAD' ID' | 


n| 




log file number 






LOG'FILE'NUM' | 


12 1 
131 




directory disc 
address 






DIRADR 


151 




ldev 1 virtual memory 
disc address 






VIRMEMADDR | 


16 1 




# LOG PROCS 








171 




LOG ID's 








18 1 
191 




RIN table 
disc address 






RINADR 


20 1 




directory size 






DIRSECT | 


21 1 


#sectors in virtual memory region 


of LDEV 1 


SECTORS IN LDEV1 VM | 


22 1 




UNUSED 








231 




RIN table size 






RINSECT ! 


2U| 




# of RINS 






RINS | 
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DISC COLD LOAD INFORMATION TABLE (CONT.) 



25 
26 

27 
28 

29 
30 
31 
32 
33 
3U 
35 
36 
37 
38 

39 
HO 
Ul 
U2 

U3 
Ul* 

U5 



# of global RINS 



|TL|RL|RY 



HIGHEST VOL # I # OF VOLUMES 
disc cold load entry point 



system disc DRT number 
Job Master Table 
Disc Address 



IDD Disc Address 


ODD Dies Address 




Welcome Message 
Disc Address 


(DST hj 

10) 




Welcome Message 
Disc Address 


(DST U8 

10) 


LOG 


ID ADDRESS 




LOG TAB ADDRESS 


LOG 


ID SIZE 




LOG 


TAB SIZE 





SIZE IN WORDS 
MEMORY ADDRESS 
DISC ADDRESS 



•DRIVER 
TABLE 



GRINS 
TL=Tape cold load 
LOAD MODE 

RL=Reload 

RY-recovery 
H'VOL' 

DISCENTRY 

SYSDISCDRT 

JMATLOC 



IDDLOC 



ODDLOC 



LOGONLOC1 



LOGONLOC2 



FAEFTR+O <- 



3-17 



DISC COLD LOAD INFORMATION TABLE (CONT.) 



SIZE IN WORDS 
MEMORY ADDRESS 



DISC ADDRESS 
SIZE IN WORDS 



MEMORY ADDRESS 
DISC ADDRESS 



SIZE IN WORDS 
MEMORY ADDRESS 



DISC ADDRESS 



SIZE IN WORDS 



MEMORY ADDRESS 



DISC ADDRESS 



SIZE IN WORDS 
MEMORY ADDRESS 



DISC ADDRESS 



SIZE IN WORDS 
MEMORY ADDRESS 



DISC ADDRESS 



*CTAB0 



*CTAB 



COMMUNICA- 
TION SUB- 
SYSTEM 
DRIVER 
TABLE 



COMMUNICA- 
TION SUB- 
SYSTEM 
DEFINITION 
TABLE 



COMMUNICA- 

SUBSYSTEM 

TABLE 



LOGICAL - 
PHYSICAL 
DEVICE 
TABLE 



FAEFTR+U 



FAEFTR+8 



FAEFTR+12 



FAEFTR+16 



FAEFTR+20 



FAEFTR+2** 
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SIZE IN WORDS 

- LOGICAL 

MEMORY ADDRESS DEVICE 
TABLE 

DISC ADDRESS 

SIZE IN WORDS 
DEVICE 

MEMORT ADDRESS CLASS 
- TABLE 

DISC ADDRESS 



FAEFTR+28 



FAEFTR+32 
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DISC COLD LOAD INFORMATION TABLE (CONT.) 



SIZE IN WORDS 
MEMORY ADDRESS 



DISC ADDRESS 



SIZE IN WORDS 
MEMORY ADDRESS 



DISC ADDRESS 



STACK SIZE 
MEMORY ADDRESS 



DISC ADDRESS 



SEGMENT SIZE 
MEMORY ADDRESS 



DISC ADDRESS 



VOLUME 
TABLE 



LOGICAL 
DEVICE 
TABLE 
EXTENSION 



INITIAL'S 
STACK 



INITIAL'S 
SEGMENTS 



FAEFTR+36 



FAEFTR+UO 



FAEFTR+U1+ 



FAEFTR+U8 



(MORE SEGMENTS OF INITIAL) 



INITIAL PROGRAM CST MAP 



LOGICAL 
CST# 



PHYSICAL 
CST# 



SEGMENT NAME 





1 
2 
3 



1 
2 
3 
k 



ININ \ 
BOOTSTRAP |- 
RESIDENT / 
MAINSEG1 \ 



•--> core resident 
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5 
6 

7 

11 

12 

13 
lU 

15 
16 

17 
20 
21 
22 



5 
6 


MAINSEG1A | 
CONFIGURE j 


| non-core resident 


7 


DEFCTRACKSJ 


|but present in core 


10 


SETUP j — 


|at completion of 


4 4 


TAPEIO ! 


icold load 


12 


FILEIO | 




13 


DISKSPACE / 




lU 


DIRECTORT1 




15 


DIRECTORY2 




16 


SL PROGRAM 




17 


PROCESS 




20 


HAINSEG1B 




21 


MAINSEG2 




22 


MAINSEG3 




23 


MAINSEGU 





•code segment swapping starts at completion of MAINSEG1 
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Virtual Disc Space Management Structures 

Disc space for data segments is allocated from reserved regions of system 
volumes which have been assigned the virtual memory supporting (VMS) attribute. 
The data structure used for accounting and management of the virtual disc 
space of the various VMS volumes is the Virtual Disc Space Management Table 
(VDSMTAB). This structure consists of a circular list of entries, one for each 
VMS volume. Each entry contains the information defining the state of the 
virtual memory region on that volume. 



Virtual Disc Space Management Table 



VDSMTAB DST# = 39 (%M) 
VDSMTABPTR= %1026 



General Structure 



+ + 

%1026 >| # VMS Volumes | 

| first to look at|--+ 

+ + 

+ >l I 

+ — | Next in list | 

I I I 

I + " "+ 

+ | Next in list | 

I I I 

I + + 

+ ->| | 

| Next in list I 

I I 

+ + 
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VDSMTAB Entry Format 



VDSMTABOO 
VDSMTAB01 
VDSMTAB02 
VDSMTAB03 
VDSMTABOU 
VDSMTAB05 
VDSMTAB06 
VDSMTAB07 



1 2 3 U 5 6 7 8 9 10 11 12 13 lh 15 

1 1 1 1 1 1 1 __i __ 1 __ 1 - = i _ = 1 = _ 1 __ 1 __ 1 __i 

._!__! — j--! — j — j — !_-!__!__!_ ,- , -, , , , 

#WORDS IN VDSMT |TABLELENGTH 
- I 

# SYSTEM VOLUMES WHICH HAVE VIRTUAL MEMORY | VMSVOLUMECNT 



INDEX OF NEXT ENTRY TO ALLOCATE FROM 
VM PAGE SIZE (512) 
# SECTORS /VM PAGE (U) 
OFFSET FROM ENTRY TO BITMAP (#20) 
TOTAL # VM PAGES CONFIGURED IN SYSTEM 



ISTARTENTRY 



I 



IVMPAGESIZE 
I 



I SECTORSPERVMPAGE 



I 



I OFFSETTOBM 



I 



LEAST # OF VM PAGES THAT HAVE EVER BEEN AVAIL . | 



I 



VDSMTAB %10-%17 UNASSIGNED 
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VDSMTAB GENERAL ENTRY FORMAT 
1 2 3 h 5 6 7 8 9 10 11 12 13 lU 15 



Word 


INDEX OF NEXT ENTRY IN CIRCULAR LIST 


Word 1 


LDEV# 


Word 2 


STARTING SECTOR OF DEVICE'S 


Word 3 


VIRTUAL MEMORY REGION 


Word k 


# SECTORS IN DEVICE'S 


Word 5 


VIRTUAL MEMORY REGION 


Word 6 


# PAGES IN DEVICE'S VIRTUAL MEMORY REGION 


Word 7 


# OF PAGES AVAILABLE IN DEVICE'S VM REGION 


Word #10 


# OF VALID WORDS IN DEVICE'S BIT MAP 


Word %11 


SIZE OF SMALLEST RECENT MISS 


WORD %12 


SMALLEST NUMBER OF PAGES EVER AVAILABLE 


%13-%20 


UN ASSIGNED 




DEVICE'S VIRTUAL MEMORY BIT MAP 




1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 




1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 



NEXTINLIST 
LDEV 

HOSTARTSECTOR 
LOSTARTSECTOR 
TOTAL SECTOR 
COUNT 

TOTAL PAGECNT 
PAGES AVAILABLE 
BMLENGTH 
SMALLESTMISS 



***COMMENT: A bit on in a device's VMBIT MAP 
==> Corresponding VM page is free. 



3-2U 



VOLUME TABLE 



SIR #22=%26 
DST #29=%35 



zero entry 
1 2 3 *♦ 5 6 7 8 9 10 11 12 13 lfc 15 
w>ard| — | — | — I--I--I--I--I — I — I — I — I — I--I — 1--I — I 

! # OF ENTRIES ! I 

0| (NOT COUNTING ZERO) | ENTRY SIZE=l6(8) |0 

I I 

lj COLD LOAD ID |1 

I " I 

2 | SYSVOLNUM I 

I— I 

3| VIRTUAL MEMORY INTEGRITY NUMBER | 

I - I 



I 1 

15 1 IllllUlillllliflllUIIIIIIIIIIIIIIIIUIUIIIII 1 13 
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TYPICAL PRIVATE VOLUME ENTRY 



















|1 
|2 




ll 

2| 










VOLUME 
NAME 






indexed by 
volume # 


31 
















13 




M 


















51 
61 










GROUP 
NAME 






15 
16 




71 
















17 
18 




10 1 


















111 
12 1 










ACCOUNT 
NAME 






19 
110 




131 
















|U 




1U| 


LOGICAL DEVICE # | 
(=0 IF NOT MOUNTED) | 


|VMS 
1 


UN|NS|SC 
1 1 1 


NS - NON-SYSTEM 

DOMAIN 
SC - SCRATCH 
UN - UNREADABLE/ 

UNFORMATTED 


151 








|VSET VTABX | 
1 1 


MVTABX 
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TYPICAL SYSTEM VOLUME ENTRY 



0| 

1| 

2| 

31 

U| 

51 

6| 

71 

10 1 

111 

12 1 

13 i 
11*1 

15! 



VOLUME 
NAME 



STARTING SECTOR OF VOLUME'S VM (0 if none) 



1 
2 



NUMBER OF SECTORS RESERVED FOR VM ON VOLUME 
(0 if none) 



LOGICAL DEVICE # 
(=0 IF NOT MOUNTED) 



|VSET VTABX | 



|VMS|UN|NS|SC 



MVTABX 



3 
U 

5 
6 

7 
8 

9 

10 

11 



indexed by 
volume # 



NS - NON-SYSTEM 

DOMAIN 
SC - SCRATCH 
UN - UNREADABLE/ 

UNFORMATTED 
VMS - VIRTUAL MEMORY 

SUPPORTING 
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CHAPTER k DIRECTORY 



Directory on disc consists of a contiguous area 
SYSGLOB cells: 

DIRBASE< absolute disk addr of base [SYSGLOB+%130 AND JH31] 



DIRBASE--- 



(WORD ADDR) 



-> 1 
— I 



LASTWORD 
FIRSTAVAIL 



— - 1 
I 



I I POINTS TO NEXT WORD TO BE EXAMINED 



I BITMAP <- 

(DIRECTORY ~ The bitmap defines the available/ 

->| SECTORS USED) | used sectors in the directory. Bit 

j JO, word corresponds to DIRBASE; 

J j bit 1 to DIRBASE+l;etc. 1=> avail- 

| j able 0=> used. [Note: BITMAP (0). 

j j (Q:U)=0 always.] 

I" I 

I • I 



DIRBASE+3- 



i 



DIRECTORY 



Directory entries contain pointers 
which are sector displacements 
relative to DIRBASE. Entries and 
indices are grouped into "blocks" 
(block = 3 sectors). 



The capacities for accounts /groups /users /files are dependent on their 
block sizes, described in the directory data segment. 



* SYSSAIBSIZE 
SYSAUIBSIZE 
SYSAGIBSIZE 
SYSGFIBSIZE 
SYSGVSIBSIZE 

* SYSAEBSIZE 
SYSUEBSIZE 
SYSGEBSIZE 
SYSFEBSIZE 
SYSMAXBSIZE 
SYSVSEBSIZE 



System acct index block size (sectors) 

Acct. user index block size (sectors) 

Acct. group index block size (sectors) 

Group file index block size (sectors) 

Group volume set definition ind. blk. size (sectors) 

Acct. entry block size (sectors) 

User entry block size (sectors) 

Group entry block size (sectors) 

File entry block size (sectors) 

Maximum of above, (used to initialize DDS.) 

Volume set definition entry block size (sectors) 



*These values are used once for the creation of the (root) system, 
account index or new systems. This root index is always at address 
DIRBASE+3. 
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ACCOUNTS 



OVERVIEW OF DIRECTORY 



SYSTEM 



/ \ \ 

/ \ \ 

/ \ \ 



I I I 
I I I 



/ \ 



KEY: 





/ 




I USERS | 


1 


/ / 
/ / 

1 1 1 


1 
\ 


1 1 1 

/ 



\ 

\ 



USERS 



| GROUPS | 

/ \ \ 
/ \ \ 

I I I I I I 

I I I I | | GROUPS 

/ \ 

/ \ 

/ \ 

/ \ 



| VSETS | | FILES | 



/ 



/ 

VSETS/ | | 
VCLASSES J J 



I I I 

- I I 



INDEX 



/ / \ 

/ / \ 

/ / \ 



I I I I 
I I I I 



/ 



/ 



ENTRY 



/ 

FILE 



| | FILE 

I | POINTERS 
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DIRECTORY DATA SEGMENT 





• 

177 






• 
• 

127 


SECTOR 

BUFFER 

128(10) WORDS 


200 


ADJUST (DB-DL) 


128 


201 


XTYPE (INPUT PARM) 


129 


202 


: XMVTABX 


130 


203 


XINDEXP (FINAL INDEX PRT) 


131 


20U 


XANAME (DB REL ADDR) 


132 


205 


XGUNAME (DB REL ADDR) 


133 


206 


XFNAME (DB REL ADDR) 


13** 


207 


XASEC (ACCOUNT SECURITY) 


135 


210 
211 


-XGSEC (GROUP SECURITY) - 


136 
137 


212 
213-2^0 ' 


SIRRETURN (FROM GETSIR) 
' DIRECTORY POINTER "A" 


138 

* 139-160 \ 

> SEE Directory 
" 161-182 / Pointer Area 


2U1-266 ' 


' DIRECTORY POINTER "B" 


267 


////////////////////////// 


183 


270 


LDEV : DIRECTORY 


18U 


271 


BASE DISC ADDRESS 


185 


SYSSATBSTZE=3 


SYS, ACCT. INDEX BLK SIZE 


186 


AUK 


ACCT.USER INDEX BLK SIZE 


187 


AGI=1 


ACCT.GRP INDEX BLK SIZE 


188 


GFI=2 


GRP FILE INDEX BLK SIZE 


189 


GVSI=1 


GRP VOL DEF INDEX BLK SIZE 


190 


AEB=3 


ACCT ENTRY BLK SIZE 


191 
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DIRECTORY DATA SEGMENT (CONT. ) 









UEB=2 


1 USER ENTRY BLK SIZE | 


192 


GEB=2 


| GRP ENTRY BLK SIZE | 


193 


FEB=2 


| FILE ENTRY BLK SIZE | 


19U 


VSEB=1 


| VOL DEF ENTRY BLK SIZE | 


195 


DDSBSIZE=3 


| MAX. SIZE DIRECTORY BLOCK | 


196 


DDSBWSIZE=%600 


| DDSBSIZE*128 | 


197 


GOODPERCENT=.85 
307 


| DISTRIBUTION | 
1 FACTOR J 


198 
199 


310 


| BASE 


200 


311 


DA AREA 


201 
DDSBWSIZE 




*" ~ 






| WORK AREA 1 
(SIZE OF LARGEST ENTRY) 


MAX 




** "* 




11U5 


DB AREA 


613 
DDSBWSIZE 



lt-U 



DIRECTORY POINTER AREA [DA OR DB] 
— 1 138/ 



DST=20(10) 
SIR=8(10) 



l l 



! DIRECTORY BASE| 



«* 



T T\«WT 

UUClV | 

ADDRESS OF PAGE IN BUFFER 



160 DIRBASE1' 



DIRECTORY PAGE IN BUFFER 



DB ADDRESS OF 1ST ELEMENT 



STARTING ADDRESS OF BUFFER 



# VALID PAGES IN BUFFER 



DIRTY FLAG 



ELEMENT SIZE 



# WORDS USED IN BLOCK 



BLOCK SIZE (SECTORS) 



BLOCK SIZE (WORDS) 



MAX # ELEMENTS/BLOCK 
l-l-l-l 



I IP j TYIELEMENT SIZE|BLOCK SIZE 
I I I I (WORDS) j (SECTORS) 
-l-l-l-l 1 



NUMBER OF ELEMENTS 



NUMBER OF ACCESSORS 



ENTRY TOTAL 



-l-l-l-l "I 

1 P I TY I ENTRY SIZE| BLOCK SIZE 
-l-l-l-l (WORDS) j (SECTORS) 
-l-l-l-l- I 



FATHER INDEX POINTER 



•-H- 

E 
R-- 



N 
A 

M 
- E- 



139/ 

3 
lUO/ 

3 
lUl/ 

3 
3.1*2/ 

3 
1U3/ 

3 

HA/ 

3 

1*5/ 
3 

3.1*6/ 

3 

3.1+7/ 
3 

1U8/ 
3 

1^9/ 

3 

150/ 



161 DIRBASE2' 
I 

i62 CONTENTS 
I 

163 LPNTR 



3.6U IOPNTR 



165 NUMVALID 
f 

3.66 DIRTY 
! 

167 XSIZE 
/ 

168 USED * 
/ 

169 BSIZE 
I 

170 BWSIZE 
i 

171 BFACTOR 



NOTE: 



** INDEXES AND 
ENTRIES 

* INDEXES ONLY 



172 MISCWD 



151/ 
3 

152/ 
3 

153/ 
3 
15V 



173 XCOUNT 
! 

Ylk PCOUNT 
I 

175 ETOTAL 
I 

176 EMISCWD 



155/ 

3 
156/ 

3 
157/ 

3 
158/ 

3 

159/ 



177 PINDEXP 



178 



179 PNAME TY 



180 



181 



I 
P 



= 0-FILE 

1-GROUP 

2-ACCT 

3 -USER 

U-VSD 
= -ENTRY BLOCK 

1- INDEX BLOCK 
= PURGE FLAG 
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DIRECTORY SPACE DATA SEGMENT (DIRSDS) 



DST=21 



10 



SIR=8 



10 



LDEV | 
DIRBASE 



LASTWORD 
FIRSTAVAIL 



BITMAP <- 



base address of parent directory 

defines last word of bit map 
defines next word to be examined 



The bitmap defines the available/used 
sectors in the directory. Bit word 
corresponds to DIRBASE; bit 1 word to 
DIRBASE+1 etc. l=>available 0=>used. 
[NOTE: bitmap(0).(0:U)=0 always.] 
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DIRECTORY STRUCTURE 



ENTRY BLOCK 



INDEX BLOCK 



INDEX 
BLOCK 
PREFIX 

INDEX 
BLOCK 
ENTRY 

INDEX 
BLOCK 
ENTRY 



ENTRY 



ENTRY 
ENTRY 



ENTRY 
ENTRY 
ENTRY 
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DIRECTORY DEFINITIONS 



>PAGE - smallest allocatable record ("phys. reed") -currently sector. 
>BLOCK - integral! of pages; contains contiguous indices or entries. 
>INDEX - pointer to entry block, containing name of 1st entry. 
>ENTRY - information-containing "object" may contain pointer to an 

index block. 
>POINTER - 15-bit positive relative page number (relative to directory 

base) . 
>DDS - directory data segment. 
>ELEMENT - a generic name for index or entry. 



INDEX BLOCK PREFIX (10 WORDS) 



0-FILE \ 
1-GROUPl 3 bits 

2-ACCT |< 

3-USER / 
lt-VSET 

PURGE FLAG< 



->| INDEX SIZE (WORDS) 
I 7 BITS 



■>| BLOCK SIZE (SECTORS) 
I U BITS 



MISCWD 



EMISCWD 




1 
2 
3 
It 

5 
6 

7 
10 
11 



-l-l— -I 

1|P| TY I XSIZE 

-l-l— "I 

XCOUNT 



IBSIZE 



IPCOUNT 



ETOTAL 

-l-l— -I — "I 

0|P| TY I EXSIZE lEBSIZE 



I— -I 



PINDEXP 



PNAME 



INDEX BLOCK INFO. 

1 NUMBER OF INDEX POINTERS 

2 NUMBER OF ACCESSORS* 

3 ENTRY TOTALS 

k ENTRY BLOCK INFO. 

5 INDEX POINTER OF FATHER 

6 \ 
I 

7 I 

8 I 
I 

9 / 



>NAME OF FATHER 



*The count is incremented by each access that uses and relies 
upon a pointer to the index block, ie, it is guaranteed not 
to be purged while the count is not = 0. 
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INDEX ENTRY (6 WORDS) 



IE1STNAME 



IEPNTR 
IECOUNT 



1st NAME OF ENTRY BLOCK 

1 

2 

3 

k POINTER TO ENTRY BLOCK 

5 NUMBER OF ENTRIES IN e BLOCK 



ACCOUNT ENTRY (%36 WORDS) 



o 


1 

i 


n 






ANAME ! 


2| 




31 




U| 


AGIPNTR | 


51 


AUIPNTR | 


61 






ACAP | 


71 




10 i 






ALATTR j 


HI 




12 i 




131 






APASS | 


1U| 




151 





1 ACCT.NAME 

2 

3 

U ACCT. GROUP INDEX POINTER 

5 ACCT. USER INDEX POINTER 



CAPABILITY 



LOCAL ATTRIBUTES 



10 PASSWORD 

11 

12 

13 
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ACCOUNT ENTRY (CONT.) 









16 
17 


ADFSCOUNT 


Ik 
15 


20 
21 


ADFSLIMIT 


16 
17 


22 
23 


ACPUCOUNT 


18 
19 


2k 
25 


ACPULIMIT 


20 
21 


26 
27 


ACONTIMECOUNT 


22 
23 


30 
31 


ACONTIMELIMIT 


2k 
25 


-—32 


I/I//I 1 1 1 1 1 1 


26 


1 33 


1 1 1 II 1 1 II 
S|A|/////| 
1 


27 


1 3U 


1 
COMM FILE REC # ACCT 


28 


1 35 


COMM FILE REC # SYS 


29 



DISC FILE SPACE COUNT (SECTORS) 
DISC FILE SPACE LIMIT (SECTORS) 
CPU TIME COUNT (SECONDS) 
CPU TIME LIMIT (SECONDS) 
CONNECT TIME COUNT (MINUTES) 

CONNECT TIME LIMIT (MINUTES) 

FLAGS (SEE BELOW) 
MAX. JOB PRIORITY 



command file location of 
account udc's 
command file location of 
system udc's (SYS acct only) 



HARD CODED 
1 



I PI//I/////I R I Rl A | A| W | W| L | L| X | X| S | S| 
•>ASECW| |//|/////|ANY |AC|ANY |AC|ANY |AC|ANY |AC|ANY |AC|ANY |AC| 



l-l-l-l-l 



I--I 



V 



|— -I-I-— |-|— -| 



l"l 
— / 



PURGE flag 



FILE SECURITY 



S If 1, system level UDC's exist (only in "SYS" account) 
A If 1, account level UDC's exist for account 
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GROUP ENTRY (%51 WORDS) 



11 

2| 
31 


--I 

! 

GNAME 


GROUP NAME 

1 

2 

3 


HI 


GFIPNTR 


U GROUP FILE INDEX POINTER 


51 
6j 

71 
10 1 


GPASS 


5 

6 PASSWORD 

7 
8 


111 
12 1 


GDFSCOUNT 


9 DISC FILE SPACE COUNT (SECTORS) 
10 


131 
lUj 


GDFSLIMIT 


11 DISC FILE SPACE LIMIT (SECTORS) 
12 


15! 
16 1 


GCPUCOUNT 


| 13 CPU TIME COUNT (SECONDS) 
|1U 


171 
20 1 


GCPULIMIT 


1 15 CPU TIME LIMIT (SECONDS) 
|16 


21| 
22 1 


GCONTIMECOUNT 


|17 CONNECT TIME COUNT (MINUTES) 
|18 


23! 
2U| 


GCONTIMELIHIT 


|19 CONNECT TIME LIMIT (MINUTES) 
| 20 


25l*P| 
26| 


GSEC 


|21 GROUP SECURITY (SEE BELOW) 
L *P = PURGE FLAG 



U-ll 



GROUP ENTRY (CONT.) 



I— " I 

271 GCAPABILITY | 23 GROUP CAPABILITY 

I 1 

30 | GLINKAGE \2k GROUP DIR. BASE LINKAGE 

I I 

31 I GVSDIPNTR | 25 GROUP VOL SET DEFN INDX 

I 1 

32 | GHVSNAME | 26 HOME VOL SET NAME 

I- "I 

331 |27 

I- "I 

3U| GHVSANAME | 28 (Definition's acct name) 

I- "I 

351 129 

I I 

36| |30 

I- -I 

371 131 

|- GHVSGNAME -| (Definition's group name) 
U0| |32 

I- -I 

Ul| 133 

I - I 

U2| \3k 

I- -I 

*3l 135 

|- GHVSVSNAME -| (Definition's vol set name) 

Ul*| 136 

I- -I 

>»5I 137 

I — - I 

1*6 1 GSAVEFIPNTR 1 38 SAVE CELL FOR GFIPNTR 

I " I 

U7l GMOUNTREFCNTR | 39 GROUP BIND COUNTER 
| 1 

50 | |U0 GSPARE 
I I 



U-12 



GROUP ENTRY (CONT. ) 



GLINKAGE (0:1) = 0; System Domain 

(0:1) = 1; Private Volumes 
(8:8) = 0; Not Bound 
(8:8) <>0; Bound 

GROUP SECURITY MASK 



1— 1— 1— 1— 

1 P I///I R 1 R 
251 |///|ANY|AC 


1 R 
JAL 


R 
GU 


| — | — | — 
| R | A | A 
|GL JANYJAC 


• 

i A 
JAL 


A 
GU 


j A i W j W 
JGL JANYJAC 


j W 
|AL 


i W 

|GU 


1 W | L | L | L 
26|GL |ANY|AC |AL 
1 — 1 — 1 — 1 — 


1 L 
JGU 


L 
GL 


| X | X | X 

JANYJAC |AL 
1 — 1 — 1 — 


1 x 

JGU 


X 

GL 


1 s | S | S 
JANYJAC JAL 
1 — 1 — 1 — 


1 s 

JGU 


1 s 

|GL 
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FILE ENTRY (FILE POINTER) (6 WORDS) 



FNAME 



FVTABINX | 
1 



FLABELADDR 



10 FILE NAME 



II 



12 

I 
13 

I 

|U VOL TABLE INDX / FILE LABEL DISC 

| ADDRESS 

15 
I 



USER ENTRY (19 WORDS) 



o 
1 

2 
3! 


UNAME 


5 


UCAP 


6 
7 


ULATTR 


10 
11 
12 
13 


UPASS 


1U 

15 
16 

17 


UHGROUP 


20 


ULOGCOUNT 


UMAXJOBW 21 


*P|U| | JOBPRI 
I I 


22 


1 1 

COMM FILE REC # 
(command file loc of 
user udc's) 



USER NAME 

1 

2 

3 

h CAPABILITY 

5 

6 LOCAL ATTRIBUTES 

7 

8 PASSWORD 
9 

10 

n 

12 HOME GROUP (MAY BE NULL) 

13 
Ik 

15 

LOG CNT (# OF USERS LOGGED ON) 

16 INIT TO 1 FOR MANAGER. SYS SO 
THIS USER CANNOT BE PURGED 

17 MAX. JOB PRI;*P=PURGE FLAG 

U=UDC EXIST FLAG 
18 



k-lk 



USER ATTRIBUTES/CAPABILITY 



/ 



SAVE FILES 



FILE-ACCESS ATTRIBUTES < 



USER 



ATTR 



\ NON-SHARABLE DEVICES- 
COMMUNICATIONS 



-SYSTEM MGR 
-ACCOUNT MGR 
-ACCOUNT LIBRN 
-GROUP LIBRN 
-DIAGNOSTICIAN 
-SYSTEM SUPVSR 

CREATE VOLS 

| USE VOLS 

I | USER LOGGING 

I I I 



| SM | AM | AL | GL | DI | OP | CV | UV | LG | // | // | // | // | CS | HD | SF | 

|__|_.|__|„|__ | __|_.|__|„|--|_-|--|-_|_-|--|--| 



1 2 3 1* 5 6 7 8 9 10 11 12 13 lU 15 
l//l//l//l//l//l//l//|BA|IA|PM|//|//|MR|//|DS|PH| 



/ batch access 
| interactive access 

ACCESS j privileged mode 

TO < 

GENERAL | multiple RINS 

RESOURCES j extra data segment 
\ process handling 



I I I 
■I I I 

— - 1 I 
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VOLUME SET DEFINITION ENTRY 

i -— -— - — ~i 

o| lo 

1| |1 VOLUME 

2 1 GVSNAME I 2 SET 

3| 13 NAME 

I I, 

TY = U|TY|1 71 MVTABX \k GVSLINKAGE 

51 VOL COUNTS 7| VMASK |5 GVSINFO 

/ 6| 16 MEMBER VOLUME 

| 7| |7 NAME (1ST ENTRY 

VOLUME | 10 1 GVSVOLUME 1 8 IS MASTER 

ENTRY < 111 19 VOLUME) 

(6 WORDS) | I — 1 

j 12 10 I 1 * I M| 10 GVSVOLFLAGS 

I " j 

\ 13| SUB-TYPE | VTABX 111 GVSVOLINFO 

i --— ! 

/ 1U| I 12 

VOLUME | . I • I • 

ENTRIES j . " 

1 - 7 < • " • " • 

I . I • j • 

\ 571 1*7 

I — - I 

60 1 IW 

I I 

6l| 1*9 

I I 

62 1 GVSVOLUME 1 50 MEM. VOL. 

| | NAME 

631 151 

I - " I 

6U| GVSVOLFLAGS (MEMBER VOLUME FLAGS) | 52 

I " — " "- I 

65| GVSVOLINFO (MEMBER VOLUME INFO) 1 53 

I — - — "I 

66| GVSDREFCNT (DEFN. REF. CNTR.) I 5 1 * 

I- " "j 

671 155 SPARE 

I — " — 1 

TY = VOLUME SET 

= 1 VOLUME CLASS 
MVTABX: MOUNTED VOLUME TABLE INDEX (IF MOUNTED) 
VOL COUNT: NO. OF VOLUMES 
VMASK: VOLUME MASK 
M = NOT MOUNTED 

= 1 MOUNTED 
VTABX: VOLUME TABLE INDEX 
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GVSLINKAGE 

l 2 3 U 5 6 7 8 9 10 11 12 13 lb 15 

I 

j T | A | NOT | MVTABX 

| | | USED | 



T - TYPE 

1 = Volume Set Definition 

= Volume Set Class 
A - ALLOCATING FLAG 

= not initialally allocating (not 1st user of set) 

1 = 1st user of set allocating resources (transitional) 
MVTABX - Mounted Volume Table Index 

if volume set not logically mounted 

G V S I N F 
l 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 

i ! 

| VOLCNT | NOT | VSMASK | 

I USED j I 



VOLCNT - Number of members in set 
VSMASK - Bit mask of volume member usage 
Order is from right to left 
i.e. bit 15 is 1st member, bit lU is 2nd member ... 

GVSVOLFLAGS 

l 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

I :— j 

I NOT USED I M | 

! !~i 

M - Member Mounted Flag 

= not mounted 

1 = mounted 

GVSVOLINFO 

1 2 1 U 5 6 7 8 9 10 11 12 13 lit 15 

,:__:___:_.:-—: i 

| DISK | VTABX i 

| SUB-TYPE | I 

I I 

VTABX - Volume Table Index 
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VOLUME SET CLASS ENTRY 



111111 
0|1:2:3|*»:5:6| 7:8:91 0:1:2|3:U:5 



o| 




1 


11 

2 


GVCNAME 


1 1 
! 2 


31 




1 3 


U| 


GVCLINKAGE 


1 u 


51 


GVCINFO 


1 5 


61 


GVCPNAME 


1 6 


71 
10 1 


GVCPANAME 


1 7 
1 8 


ill 




1 9 


12 1 




10 


131 
lk\ 


GVCPGNAME 


li 

12 


151 




13 


16 1 




Ik 


171 
20 1 


GVCPVSNAME 


15 
16 


21 




17 


22 1 





18 


231 
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VOLUME CLASS NAME 



VOLUME CLASS IDENTIFICATION 
VOLUME CLASS INFORMATION 
PARENT VOLUME SET DEFINITION 

ACCOUNT OF PARENT DEFINITION 



GROUP OF PARENT DEFINITION 



VSNAME OF PARENT DEFINITION 



671 



155 



k-iB 



GVCLINKAGE 



I 

I T | | 

i I I 



7 8 9 10 11 12 13 1U 15 



NOT 
USED 



I 



T - TYPE 

1 = Volume Set Definition 
= Volume Set Class 

G V C I N F 



1 2 3 ** 5 6 7 8 9 10 11 12 13 l 1 * 15 

I I 

| VOLCNT | NOT | VCMASK | 

| | USED | I 



VOLCNT - Number of members in set 

VCMASK - Bit mask of volume member usage (VOLUME CLASS MASK) 
Order is from right to left 
i.e. bit 15 is 1st member, bit lU is 2nd member ... 

VOLUME MASK FORMAT 



USED IN MVTAB, PVUSER, FILE CONTROL BLOCK (FCB), 
VOLUME SET/CLASS DEFINITION, VOLUME SET VTAB. 
8-BIT MASK. 



| V7 | V6 | V5 | VU | V3 | V2 | VI | V0 | 



I I I 

| | — VOLUME (MASTER) 



I 



VOLUME 1 
VOLUME 2 
VOLUME 3 
VOLUME U 
VOLUME 5 
VOLUME 6 



: «OT nOuwxaiJ On «u«-n&ni5Cii\ 



VOLUME 7 

MOUNTED OR MEMBER 
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CHAPTER 5 LOCK RESOURCES 



SIR# ALLOCATION DST J&53 



decimal 


octal 




SIR # 


SIR # 


SIR NAME 


-> 1 


1 


LOAD PROCESS SIR 


2 


2 


LOCK SEGMENT SIR 


3 


3 


IDD 


k 


U 


ODD 


5 


5 


PROCESS TREE STRUCTURE 


6 


6 


SCHEDULING QUEUE 


7 


7 


CST ENTRIES 


8 


10 


SYSTEM DIRECTORY 


9 


11 


LPDT 


10 


12 


LDT 


11 


13 


STORAGE IN OVERLAY AREA 


12 


Ik 


DISC FREE SPACE TABLE 


13 


15 


JPCNT 


1U 


16 


JCUT 


15 


17 


JMAT 


16 


20 


FMAVT 


c? 


~~2T> 


LOADER SEGMENT TABLE 


18 


22 


VDD 


19 


23 


SPOOL 


20 


2U 


MESSAGE CATALOGUE 


21 


25 


RIT 


22 


26 


VOLUME TABLE 


23 


27 


WELCOME MESSAGE SIR 


2k 


30 


ASSOCIATION TABLE 


25 


31 


CS ALLOCATE SIR 


26 


32 


LOGGING BUFFER 


27 


33 


PV MVTAB 


28 


3k 


MEASSIR 


29 


35 


PV USER TABLE 


30 


36 


IMAGE 


31 


37 


ESAM 


32 


Uo 


USER LOGGING 


$ 33 


kl 


DEBUG BREAKPOINT TABLE 


$ 3U 


k2 


PCBSIR 


35 


k3 


SUB-QUEUE MAPPING TABLE 


^6 


kk 


CILOG 


<3T~~-^ 


- — ~^>r> 


FILE INTEGRITY 


38 


k6 


RIN 


39 


k7 


TAPE LABELS 


1*0 


50 


1st JOB 


Ul 


51 


2nd JOB 
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MULTIPLE SIR ALLOCATION 



The five conventional chains used by MPE for SIR allocation and 
deallocation are: 



LOWER- >LOGICAL RANK->HIGHER 

1. LDT(10)->LPDT(9)->VDD(18) 

2. JMATSIR(15)->LPDT(9)->JPCNT(13) 

/f>\ FMAVTSIR(l6)->FILESIR(37)->DIRECT.(8)->DISC FREE SPACE TBLE(12) 

Jl/ FMAVTSIR(l6)->FILESIR(37)->RINTABLE(38) 

5- SEGTABSIR (%2l)-> BKPTSIR(%Ul)-> LOCKSIR(2) 

6. JMATSIR(15)->LDT(10)->LPDT(9)->ODD(lt) 



Multiple SIR allocation requires care to avoid process deadlock 
situations. The rule that should be followed when working with 
the above SIRs is as follows: 

Never attempt a GETSIR of lower rank then the SIR currently held 
(if any). 



For example: 



suppose two processes, A and B, required the SIRs for 
the LDT and LPDT. Deadlock would result if done as 
below due to process A not following the convention 
order . 



incorrect order 



correct order 



PROCESS A 



PROCESS B 



GETSIR(9) [LPDT]<- 



•>GETSIR(10) [LDT] 



GETSIR (10) 



-GETSIR (9) 



DEADLOCK 
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SIR TABLE INFORMATION 



The system internal resource table is located in non-linked memory 
(resident table). The SIR table is used to protect critical system 
elements against access by more than one process, i.e., it provides 
a "lock out" mechanism. Each critical system resource (usually a 
table) is assigned a specific SIR number. Procedures are provided 
within MPE to lock (GETSIR) and unlock (RELSIR) the SIR. Processes 
attempting to obtain a SIR that is not available are impeded by the 
system. The SIR table entries form the head of a linked list in 
this case. If more than one process becomes impeded, word 8 of the 
PCB entry is used to add the "new" process to the growing list. 
The method of dis impeding the process depends on the SIR type. 



A SIR does not respect process priority and operates in a FIFO 
manner. As processes become impeded on behalf of a SIR the new 
entries are entered at the tail of the impeded list. When the 
current holder of the SIR releases it, only the first process 
in the list (pointed at by the head pointer) is dis- impeded. 
The linked list head and all pointers are then updated and the 
newly dis -impeded process will obtain the SIR. 
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SIR ENTRY FORMATS 



1 2 3 U 5 6 


7 


8 9 10 11 12 13 1U 15 
. i i i i ■ i ■ 










PIN of holder 


1 










PIN of holder 


1 


SIR QUEUE LENGTH 


TAIL OF IMPEDED LIST(P)|HEAD OF IMPEDED LIST(P) 



free 

(not locked) 

SIR locked 

(no impeded processes 

SIR locked 

1 (impeded processes) 



P = PIN# 

PIN = PCB table entry number 

SIR QUEUE LENGTH- number of processes queued for this SIR 

The SIR table is indexed by SIR#, each SIR# corresponding to a unique, 
preassigned system internal resource. Entry #0 is not used. 
Impeded lists are established by using the SIR table entry (1). 
(8:8) as the head of the list and PCB(8). (8:8) for elements. 
Pin numbers are always used as pointers, with indicating end 
of list. 
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RIN TABLE GENERAL LAYOUT (Initialized State) 



DST=#26 



RT=RIN TYPE 
(WHEN 
ALLOWED) 



1 -LOCAL RIN 
2 -GLOBAL 

RIN 
3 -FILE RIN 



SECONDARY 
TABLE OF 12- 
WORD ENTRIES 
FOR GLOBAL 
RIN'S ONLY 



RT 



RT | 



RT 



RT 



RT | 



RT 



INDEX OF FIRST FREE ENTRY 



(# LOCAL+GLOBAL RINS)*2 



INDEX OF NEXT FREE 


INDEX OF NEXT FREE 



INDEX OF NEXT FREE 



INDEX OF NEXT FREE 



INDEX OF NEXT FREE 



O(EOL) 


FREE LIST POINTER 

TOTAL #OF ENTRIES 

NUMBER FREE ENTRIES 

RESERVED 



IF FREE, PTT TO NEXT FREE| 
— -I 



I 

LENGTH* 

# ALLOCATED 

GLOBAL RINS 

•12 



| FIKST 
<- FREE 
- ENTRY 



I 

1 <- 



| LAST 
! < - FREE 
ENTRY 



|0< 

U 



HO 
111 
I 
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ALLOCATION AND LOCKING OF LOCAL RINS 



JOB INFOR- 
MATION 
TABLE 



(JIT) 




1| 



1| 



1 



RIN TABLE 

INDEX OF FIRST FREE ENTRY 

(NUMBER OF LOCAL+GLOBAL RINS)*2 



DST22(10)=26(8) 



INDEX OF NEXT RIN 



INDEX OF NEXT RIN 



END OF LIST 



I 

HEAD OF WAITING LIST 



PIN OF HOLDER (P) 



I 



LOCAL 

RIN #1 
(UNLOCKED) 



LOCAL 
RIN #2 
(UNLOCKED) 



<- LOCAL 

RIN #3 

-| (LAST) 

(LOCKED) 



P = PIN# 



v 
PCB# 



waiting processes 
linked through 
PCB impeded queue 
(PCB# pointers) 



PCB# PCB# of process 
that "holds" rin 
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ALLOCATION AND LOCKING OF FILE RINS 



DST22(10)=26(8) 





RIN TABLE 




INDEX 


OF FIRST FREE 


ENTRY 


(NUMBER 


OF LOCAL+GLOBAL 


RINS)*2 



1 1 1 ///////////////////////////////////////// 

HEAD OF WAITING LIST(P)! PIN OF HOLDER 
I I 



PCB# waiting processes 
linked through PCB 
impeded queue 

P=pin# 



! 

v 

PCB# process that 
"holds" rin 
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ALLOCATION AND LOCKING OF GLOBAL RINS 



DST22(10)=26(8) 



PCB# <- 

waiting 
processes 



RIN TABLE 

INDEX OF FIRST FREE ENTRY 

(NUMBER OF LOCAL+GLOBAL RINS)*2 



1 0| INDEX OF PASSWORD, USERNAME 



HEAD OF WAITING LIST(P) | PIN OF HOLDER 



P=pin# 



RIN PASSWORD 



USERNAME 
(USER NAME AND ACCOUNT) 



•>PCB# 

process 
that 

'holds ' 
RIN 
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CHAPTER 6 FILE SYSTEM 



1 . Introduct ion 



This document describes the MPE-IV file system. Section 2 describes the 
basic concepts. Section 3 describes the table structures used. 



2.0 File System Overview 



I/O to files is done by reference to file numbers, which are assigned by 
calling the FOPEN intrinsic. This establishes an initial "point of 
attachment", which may be described as a connection between a program 
(i. e., process) and that particular point in a particular file at which 
the next FREAD or FWRITE would cause data to be transferred. A point of 
attachment is described by a control block, of which there are several 
different kinds (described later). Control blocks may exist in the 
process's own stack, in an extra data segment assigned by the file 
system, or (because of file sharing) in some other process stack. In 
order to find control blocks quickly, a pointer scheme called vectors is 
used. A control block is uniquely described by a vector, which consists 
of one word with the low ten bits containing a segment number, and the 
upper six containing an index into a table (the "vector table") which 
describes the location of the control block within that segment. The 
entire assemblage, consisting of five overhead words, the vector table, 
and all of the control blocks to which it points, comprises a contiguous 
piece of storage called the "control block table". If it is in an extra 
data segment, the control block table comprises the entire segment; if 
in a stack, it occupies part of the PXFILE part of the PCBX, usually 
beginning at segment-relative location 106 octal. 

The point of attachment is described by a "physical access control 
block", or PACB, which will exist as a result of an FOPEN to any file 
(except $NULL). Any required I/O buffers are associated with the PACB; 

All FOPENs specifying "multi-access" for all processes running under a 
single job use a single PACB for references to a multi-access file. 

A1+V>rviitrV> all ihaca a-i-a a+.+.a cVioH +.r> a sincrle T^OITlt in the file, the tVDe 

of attachment (i. e., A0PTI0NS) may be different. So, each FOPEN 
specifying a multi-access file establishes a "logical access control 
block", or LACB, which contains the point -of -attachment local values. 
The use of a single buffer (i. e., PACB) insures that references by 
various processes or against various FOPENs within one process are dealt 
with in strict sequential order. Note that references to a file by 
other jobs, or by other processes not specifying multi-access, will b€ 
through other PACBs, whose buffers will be read or written at the 
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pleasure of the file system; in order to insure any sort of coherence to 
such shared references, the jobs must use global RINS and FLOCK and 
FUNLOCK the file. $STDIN, $STDLIST, and spoolfiles are opened 
multi-access automatically. 

In the case of disk files, there is another kind of control block: the 
file control block, or FCB. It contains copies of information read from 
the file label, such as the end- of-file pointer, the extent map, and 
the record and block structure. The EOF pointer is updated in the FCB 
as the file is written, and all changes made to the FCB are posted to 
the file label when the file is closed. An FCB is shared by all jobs in 
the system which reference the file. 

The file number assigned by an FOPEN is an index into the Available File 
Table (AFT) , a table of four-word entries which is at the end of the 
PXFILE part of the PCBX. Two of these words are vectors to the PACB and 
(if it exists) the LACB. 

Because control blocks are shared among processes, it is necessary to 
have a scheme for coordinating access to them. A control block is 
"locked" by a process which requires exclusive access to it for a time. 
Other processes which attempt to lock the block will find it already 
locked, and will be impeded and queued. It may also be necessary to 
lock an entire control block table so that a process can create or 
destroy a control block in it, or lock or unlock an existing control 
block in the table. 

Another table used by FOPEN is the File Multi-Access Vector Table 
(FMAVT) . This table exists in a system extra data segment and is used by 
all jobs and processes in the system. When a file is being FOPENed with 
multi-access specified, the FMAVT is searched; if the file is already 
open, the FMAVT gives the PACB vector for the prior reference for each 
job. 



2.1 Buffers 



A bit in AOPTIONS specifies, when a file is opened, whether access is to 
be buffered or unbuffered. If unbuffered, data is transferred directly 
between the I/O device and the user's buffer (usually in his stack), 
which will be frozen in memory for the duration of the transfer. If 
buffered, the data is moved between the user's buffer and a file system 
buffer to which the I/O is actually done. 

Buffers are associated with the PACB, attached to it as an appendage. 
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3.0 Table Formats 



This section gives a detailed discussion of the main tables constructed 
and used by the file system. The location and overall structure of each 
table is given, in addition to the table format and a discussion of each 
field in the table. Table indices at the right of the table are in 
octal. Index names apply to the entire word; if in parentheses, the 
names are defined in the file system listing but not explicitly used 
there . 



3.1 File System Section of PCBX (PXFILE) 



The PXFILE area is a sub-section of the PCBX. It is a contiguous, 
expandable and contractable block of storage that is managed by the file 
system primarily for its own use. Other subsystems, namely CS and DS, 
also make use of the PXFILE section. In doing so they must conform to 
the conventions of the file system. 

The overall structure of the PXFILE area is: 



66 



Overhead 



(fixed) 



106 



Control block 
table 



(variable) 



Available 



(variable) 



Active File 



(variable) 



I DL-5 
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3.1.1 Overhead 



The part labeled Overhead contains information that pertains to the 
entire section. It ordinarily begins at segment-relative location 66 
octal, but is usually addressed via the pointer at DL-3* 



PXFSIZE 

1 

2 

3 (PXFDSINFO) 

k 

5 PXAFTSIZE 

6 (PXCTRINFO) 

10 PXFCBT1 

11 (PXFCBT2) 

12 (PXFCBT3) 

13 (PXFCBTU) 
lU (PXFCBT5) 

15 (PXFCBT6) 

16 (PXFCBT7) 

17 (FXFCBT8) 



1 




7 8 




15 


| PXFILE size in words | 


j Last DOPEN error 


no . | Last 


COPEN 


error no. | 


|N| I 


| Reserved for DS I 


j Last KOPEN error number | Last FOPEN error number j 


| AFT size in words I 




CS 


Trace file info 




| Last responding 


NO- WAIT I/O AFT entry number j 


| 1st user 


(NOBUF) 


control block 


table 


DST number j 


| 2nd user 


(NOBUF) 


control block 


table 


DST number j 


| 3rd user 


(NOBUF) 


control block 


table 


DST number j 


| Uth user 


(NOBUF) 


control block 


table 


DST number j 


| 5*h user 


(NOBUF) 


control block 


table 


DST number j 


| 6th user 


(NOBUF) 


control block 


table 


DST number j 


j 7th user 


(NOBUF) 


control block 


table 


DST number | 


| 8th user 


(NOBUF) 


control block 


table 


DST number j 



Partial word field identifiers are: 



PXFDOPEN 

PXFCOPEN 

PXFNOCB 

PXFKOPEN 

PXFFOPEN 

Discussion: 

PXFAFTSIZE 



= PXFILE(1).(0:8)#, 
= PXFILE(1).(8:8)#, 
= PXFILE(2).(0:1)#, 
= PXFILE(U).(0:8)#, 
= PXFILE (U). (8 :8)#, 



last DOPEN error code 
last COPEN error code 
no CB's in PXFILE CBT? 
last KOPEN error code 
last FOPEN error code 



This is the size (in words) of the Active File Table 
(AFT). The size is in words to simplify calculating the 
size of the available block. 
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PXFCBT1-8 

PXFCOPEN 

PXFCTRINFO 

PXFDOPEN 

PXFDSINFO 

PXFFOPEN 



PXFKOPEN 



PXFLEFTOFF 



PXFNOCB 



PXFSIZE 



These are the DST numbers of the user (NOBUF) control 
block tables. A DST number of indicates that no data 
segment is allocated. 

This ^contains the last COPEN error number. Not used by 
the file system. 

This contains information pertinent to the CS trace 
file. Not used by the file system. 

This contains the last DOPEN error number. Not used by 
the file system. 

Reserved for DS. Not used by the file system. 

This contains the last FOPEN error number. If it is 
zero then the last FOPEN completed successfully; 
otherwise the last FOPEN was unsuccessful and the 
number is the file system error number. 

This contains the last KOPEN error number. KSAM is 
partly imbedded in the file system, and an FOPEN 
failure on a KSAM file can be caused by a failure to 
open either the key file or the data file. This error 
number is used in conjunction with PXFFOPEN to 
determine which file caused the KSAM open failure. 
This error number is not used by the file system. 

This is the AFT entry number of the last file/line that 
completed a no-wait I/O; if zero then no no-wait I/O 
has been completed. This cell is maintained solely by 
and for the IOWAIT intrinsic. 

This bit signifies that control blocks are not to be 
created in the PXFILE control block table. This bit is 
set by the NOCB parameter to the CREATE intrinsic or 
the :RUN command. This feature permits the user to 
have as much stack space as possible; otherwise the 
file system will take several hundred words of stack 
for the PXFILE control block table. 

This is the size (in words) of the complete PXFILE 

9UPSSI « XI* XS UI1C S5U1I1 Ul WJ.C VY^J. Al^CfcW. fc/J-vv,.**. > w***» ww**w*w*. 

block table, the active file table and the available 
block. 
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3.1.2 PXFILE Control Block Table (PXFCBT) 



Addressing within a PXFILE control block table is somewhat more 
complicated than addressing an extra data segment CBT since the table 
does not begin at DB+0. As a result all pointers within the table are 
table relative; the starting address of the table must be added to a 
pointer to generate a final DB-relative address. This addressing 
convention is consistently applied to all control block tables. 

When the control block table is expanded, space is taken from the 
AVAILABLE area. If no space is available then the PXFILE area is 
expanded and the acquired space is added to the AVAILABLE area. 



Refer to section 3>2 for a more detailed 
block tables. 



description of file control 



15 



Table size in words 



DST number containing table 

Vector table size in words 



Lock word 
Impeded queue 



Vector table 



Control block area 



20 (PXFCBTAB) 

21 PXFDSTX 

22 PXFVTSIZE 

23 (PXFLOCK) 
2k (PXFQUEUE) 
25 PXFVT 



The following identifier is also used: 

PXFCBTSIZE = PXFILE(l6)#, table size in words 
Discussion: 
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PXFCBTAB 



PXFCBTSIZE 



This is the first word of the control block table; it 
is used when referring to the entire table. 

This is the size in words of the control block table. 
It is used principally for calculating the size of the 
available block. 



PXFDSTX 



This is the DST number of the data segment that 
contains the control block table. This is the same as 
the DST number of the stack itself. The common 
convention of referring to the DST number of the stack 
as zero is not used, because the file system may refer 
to a PXFILE control block table in another stack, which 
would result in an ambiguity since that PXFILE control 
block table would also have a DST number of zero. 



PXFLOCK 



PXFQUEUE 



This is the lock word for the table and has the same 
format as the lock word for a control block in the 
table, i. e. lock bit, break bit, lock count, and 
locking PIN. 

This is the impeded queue for the table and has the 
same format as the impeded queue for a control block in 
the table. 



PXFVT 



PXFVTSIZE 



This is the first word of the vector table. It is used 
when referring to the vector table in general. 

This is the size, in words, of the vector table. This 
is the length of the table and does not reflect the 
number of entries used or unused. 



3.1.3 Available Block 



The part labeled Available is used to provide space when the Control 
Block Table or the Active File Table is expanded. These two tables grow 
towards each other, and when more space is needed it is simply taken 
from the Available Block. 



_ j_ _ j -«_ 



we rAf xub area, is expeuiueu, 



wnen xne Avaixaoxe area is exnaus^ea 

AFT is relocated and the new space is added to the Available Block. 

Currently the PXFILE area is only expanded; it is never contracted. 
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3.1.U Active File Table (AFT) 



The part labeled Active File Table contains information used by the file 
system (or CS, DS, etc.) to grossly characterize the file access and, 
most importantly, to give the location of the control blocks. 

The overall structure of the AFT is: 



Entry N 



(fixed, U words) 



Entry 1 



DL-8 

(fixed) 
DL-5 



where H = PXFAFTSIZE/H. 

The length of the AFT is specified by PXFAFTSIZE. Unused entries are 
all zeroes. When the table is full it is expanded by taking space from 
the Available block. 

The AFT is negatively indexed by file number: the entry at DL-8 
corresponds to file number 1, the entry at DL-12 corresponds to file 
number 2, etc. 

The structure of a file system AFT entry is: 



1 2 3 U 5 


15 


| Entry type I N | 1 


j Physical ACB Vector | 


| Logical ACB Vector I 


| NO-WAIT I/O IOQX 1 



1 AFTPACBV 

2 AFTLACBV 

3 AFTIOQX 
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The entry format depends on the entry type; the file system uses entry 
type 0. 

The following partial word field identifiers are used: 

AFTTYPE =AFT.(0:U)#, entry type 
AFTNULL = AFT.(U:l)#, $NULL file 



Discussion: 

AFTIOQX This is the IOQ index of the pending no-wait I/O (if 
any). This is applicable iff the file was opened with 
the NOWAIT option specified. Also, CS and DS have the 
same capability and use this cell in a consistent 
manner. This is because the IOWAIT intrinsic services 
the file system as well as CS and DS, and is the prin- 
cipal user of this cell. In the case of a message file 
the accessor 's reply port (file system basic IPC port) 
is stored in this cell. If this cell is zero there is 
no no-wait I/O pending. 

AFTLACBV This is the vector of the Logical ACB (LACB) (if any). 
This is applicable iff the file was opened with the 
multi-access option specified. 

AFTNULL This bit signifies that the file is $NULL and that 
there are no control blocks. 

AFTPACBV This is the vector of the Physical ACB (PACB) . A PACB 
exists for all files except $NULL. 

AFTTYPE This is the AFT entry type number. At present the 
following entry types are defined: 

- file system 

1 - remote file 

2 - DS (no-wait I/O disallowed) 

3 - DS (no-wait I/O allowed) 
k - CS 

5 - CS 

6 - KSAM 

8 - Message File 
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3.2 File Control Block Table (CBTAB) 



A file control block table can be located in two places: (a) as a 
sub-part of the PXFILE area, as discussed in section 3-1.2; or (b) in a 
data segment. Although putting control block tables in PXFILE has the 
advantage of providing rapid access, it detracts from the space for the 
user's stack; so the larger control blocks (or optionally, all control 
blocks) are put into extra data segments. On the other hand, 
referencing extra data segments may result in an absence trap, which is 
slow. Extra data segment control block tables are of three kinds: 
expandable, non-expandable, and shared FCB. Non- expandable CBT's are 
used for a single PACB with buffers, i. e. where the control block is 
large, or where the control block can't be local to a single process, i. 
e. , for multi-access. Expandable (or NOBUF) CBT's are used for small 
control blocks, to wit, LACB's, PACB's with no buffers, and FCB's which 
are local to a single process. A list of the expandable CBT's 
associated with a process is kept in the overhead area of PXFILE (cf . 
section 3*1.1). When a small control block is needed, these CBT's are 
checked in order to see if one of them has room. Shared FCB CBT's are 
like expandable CBT's except that they belong to the system rather than 
to a single process; the system keeps a list of DST's which it has 
assigned for this purpose. 

The overall structure of a control block table is: 



Overhead 



(fixed, 5 words) 



Vector Table 



(variable) 



Control Block 
area 



(variable) 
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3.2.1 Overhead 



The part labeled Overhead contains information pertaining to the entire 
table . 



12 



6 7 
Table size in words 
DST Number containing table 
Type | | Vector table size in words 

Lock word 
Impeded queue 
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i CBTSIZE 

1 CBTDSTX 

3 CBTLOCK 

U (CBTQUEUE) 



Other identifiers used: 



CBTTYPE = CBTAB(2). (0:2)#; control block table type 
CBTVTSIZE = CBTAB(2).(7:9)#; vector table size 



Discussion: 
CBTDSTX 



CBTLOCK 



CBTQUEUE 



CBTSIZE 



This is the DST number of the data segment that 
contains the control block table. If the table is 
contained in a stack, i.e. in the PXFILE area, then 
this is the DST number of the stack and not 0. 

This is the lock word for the table and has the same 
format as the lock word for a control block in the 
table, i. e. lock bit, break bit, lock count, and 
locking PIN. The table is locked, thus insuring 
exclusive access, whenever a control block is being 
created or destroyed. It isn't necessary to lock the 
table while locking a control block within it because 
control block locking is done pseudo-disabled. 

This is the impeded queue for the table and has the 
same format as the impeded queue for a control block in 
the table. There is no second impeded queue because 
that facility is used exclusively for BREAK requests 
against the PACB for $STDIN/$STDLIST. 

This is the size in words of the table. It is 
initialized when the table is created and changed when 
the table is expanded. At present a table is never 
contracted, even though this is possible. 
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CBTTYPE This field is the type of the control block table. 
Possible values are: 

- stack [PXFILE] 

1 - NOBUF (expandable) 

2 - System shared FCB 

3 - Buffered (contains a single PACB) 



CBTVTSIZE This is the size, in words, of the vector table area in 
the control block table. It does not reflect the 
number of entries used or unused. 
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3.2.2 Vector Table 



The part la"beled Vector Table contains information used to locate and 
lock or unlock control blocks in the control block table. 

The overall structure of the vector table is: 



Entry 



(fixed, U words) 



Entry N 



(fixed) 



where N = (CBTVTSIZE/U)-1. Since only six bits are available for a 
vector table index, the vector table can contain at most 6k entries. 

An unused vector table entry will have zeroes in all the words of the 
entry. A used vector table entry will have a non-zero value in the 
first word of the entry (the control block address is necessarily 
non-zero) . 



The general structure of a vector table entry is: 



Control block address 
Control word 



High priority impeded queue 
Low priority impeded queue 



15 



VTADR 

1 VTCONTROL 

2 (VTQUEUE) 

3 (VTSAVEDQUEUE 



Discussion: 
VTADR 



Control block address is the table relative address of 

mac wvu v* vju fcsa.vtwA aaawv -tci. v«U rt J- uu uuc v ^\- wwj. vui/x« 
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VTCONTROL 



VTQUEUE 



VTSAVEDQUEUE 



entry. It is a word displacement from the beginning of 
the control block table. 

The control word is used to coordinate access to the 
control block. It contains a bit which indicates that 
the control block is being accessed, and therefore 
"locked", and a byte which contains the PIN of the 
process which has exclusive access to the control 
block. Other processes attempting to access the block 
will be impeded and queued. 

The high priority impeded queue is a byte pair of PINs 
that are the head and tail of the impeded queue of 
processes waiting for access to the control block. 
Processes are impeded and unimpeded by the file system 
using the normal mechanisms available under MPE. 

The low priority impeded queue is a byte pair of PINs 
and has the same format as VTQUEUE. The only time this 
word is used is when the control block is in BREAK 
mode, which can only happen to an ACB corresponding to 
$STDIN/$STDLIST. It is used to save the current 
VTQUEUE when the control block goes into BREAK mode and 
to restore VTQUEUE when the control block goes back 
into non- BREAK mode. 



The last three words of a vector table entry comprise a sub-block for 
the locking system that is used to coordinate access to a particular 
control block. 

The structure of the vector table entry control sub-block is: 



12 7 8 15 

L I B I Lock count | Lock PIN | CBLCONTROL 

- I 

High priority tail PIN | High priority head PIN | 1 CBLQUEUE 

— I 

Low priority tail PIN | Low priority head PIN | 2 CBLSAVEDQUEUE 



The following partial word field identifiers are used: 



CBLLOCK 

CBLBREAK 

CBLCOUNT 

CBLPIN 

CBLTAIL 

CBLHEAD 

CBLSAVEDTAIL 



CBL.(0:1)#, 

CBL.(1:1)#, 

CBL.(2:6)#, 

CBL.(8:8)#, 

CBL(1).(0:8)#, 

CBL(1).(8:8)#, 

CBL(2).(0:8)#, 



lock bit 

break bit 

lock count 

PIN holding lock 

high priority tail PIN 

high priority head PIN 

low priority tail PIN 
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CBLSAVEDHEAD 



= CBL(2).(8:8)#; low priority head PIN 



Discussion: 
CBLBREAK 

CBLCONTROL 

CBLCOUNT 



CBLHEAD 
CBLLOCK 
CBLPIN 

CBLQUEUE 
CBLSAVEDHEAD 

CBLSAVEDQUEUE 

CBLSAVEDTAIL 

CBLTAIL 



This is the BREAK bit and is used only for the ACB 
corresponding to $STDIN/$SDTLIST. 

This identifier is used when referring to the first 
word of the vector table control sub-block. 

This is a count of the number of times that the control 

block is locked by CBLPIN. It is if the control 

block is not locked and is greater than if the 
control block is locked. 

This is the PIN of the process at the head of the high 
priority impeded queue. 

This is the lock bit for a control block; 1 denotes 
locked. 

This is the PIN of the process which has locked the 
control block and has exclusive access to it. If the 
control block is not locked then this field is 0. 

This is the high priority impeded queue. 

This is the PIN of the process at the head of the low 
priority impeded queue. 

This is where CBLQUEUE is saved when creating a break 
queue . 

This is the PIN of the process at the tail of the low 
priority impeded queue. 

This is the PIN of the process at the tail of the high 
priority impeded queue. 
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3.2.3 Control Block Area 



The part labeled CONTROL BLOCK AREA contains the control blocks used by 
the file system. 

To facilitate storage management, all control blocks have the same 
overall structure: 




CBDESCRIP 

1 



N 



where N = Size-1. 

Partial word field identifiers are: 



CBTYPE 
CBSIZE 



CB.(0:2)#, 
CB.(2:lU)#; 



control block type no. 
control block size 



Discussion: 



CBDESCRIP 



CBSIZE 



CBTYPE 



This is the first word of a control block; the format 
is common for all control blocks. 

This is the size (in words) of the control block. The 
size includes the descriptor word. 

This is the type number of the control block. There 
are four types of control blocks: 

- Garbage 

1 - FCB 

2 - PACB 

3 - LACB 



When a control block table is created the initial control block area is 
completely allocated to a single control block of type garbage. When 
space is requested for a new control block the control block area is 
scanned (using a first fit algorithm) for a garbage control block that 
is as large as the size requested. The space for the new control block 
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is taken from this garbage control block and the space remaining becomes 
the new garbage control block size. 

When space is returned it becomes a new garbage control block. To 
reduce fragmentation the new garbage control block is combined with 
either of the two neighboring control blocks if they are of type 
garbage . 

If space is requested and no garbage control block is large enough to 
contain the new control block then the control block area and control 
block table are expanded by a sufficient amount. If expansion is not 
possible, some other control block table must be used. 



3.2.U Access Control Block (ACB) 



Virtually every file system intrinsic constructs an ACB as its first 
action. When using the multi-access option, each accessor shares a 
single PACB. However each accessor is permitted to view the shared file 
in a slightly different manner than the other accessors. For example, 
one accessor may access the file in a read-only mode while the other 
accessors may access the file in a read -write mode. To do this, each 
accessor must, during his access, have a slightly different ACB. 

The PACB holds information that is global to all accessors of the file. 
The LACB holds information that is local to each accessor of the file. 
At the beginning of a particular access, an ACB is constructed by 
calling LOC'ACB, which copies information from both the LACB and the 
PACB. At the end of the access, the ACB is released by calling 
UNLOC'ACB; this updates the PACB and LACB from the ACB since some of the 
fields may have been modified due to the access. This scheme nearly 
eliminates EXCHANGEDB's to access the various data segments. 
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3.2.5 Logical Access Control Block (LACB) 

All LACBs have the same structure: 

1 2 3 h 5 6 7 8 9 10 11 12 13 lU 15 
3 I Complete LACB size 







File number 


File name 


- 1st char. 


File name - 2nd char. 


File name 


- 3rd char. 


File name - Uth char. 


File name 


- 5th char. 


File name - 6th char. 


File name 


- 7th char. 


File name - 8th char. 



F0PTIONS 


AOPTIOMS 


Record size in bytes 


Block size in words 


Reserved for PACBV 


Carriage control code 


|E0F|Pg 


|Ln 


|St |FK |TC |TB |8B |Car|DB | 


EOF 


T 


EOF M | 






| TE| IC| Q | | Terminal 


stop 


character 


Error code 


Last I/O transmission log 



Partial word field identifiers are: 



LACBSIZE = LACB. (2:lU)#, size in words 
LACBSTOPCHAR = LACB(2) . (0:8)#, terminal stop character 



Discussion: 

LACBAOPTIONS See ACBAOPTIONS. 

LACBBSIZE See ACBBSIZE. 
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10 
11 
12 
13 
Ik 

15 
16 

17 



LACBCTL 

LACBERROR 

LACBFNUM 

LACBFOPTIONS 

LACBMODE 

LACBNAME1-8 

LACBPACB 

LACBRSIZE 
LACBSIZE 

LACBSTATE 

LACBSTOPCHAR 

LACBTLOG 



See ACBCTL. 

See ACBERROR. 

See ACBFNUM. 

See ACBFOPTIONS. 

See ACBMODE. 

See ACBNAME. 

This is the vector of the Physical ACB (PACB) for the 
file. 

See ACBRSIZE. 

This is the size, in words, of the LACB. All LACBs are 
sixteen (decimal) words long. 

See ACBLSTATE. 

See ACBSTOPCHAR. 

See ACBTLOG. 
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3.2.6 Physical Access Control Block (PACB) 



The overall structure of the PACB is: 



Basic PACB 



(fixed) 



Buffering 
extension 



(variable) 



The buffering extension is optional; it is present if and only if the 
file is accessed with buffering. There are thus two possible formats 
for an ACB: 

1. No buffers; the buffering extension is not present. 

2. PACB buffers; the buffering extension is present and the 
buffers are in the buffering extension. 

If multiple PACB buffers exist, there will be a buffering extension for 
each, immediately preceding the buffer. The basic PACB (or NOBUF PACB) 
is copied into the the ACB as words thru 57 octal; an ACB "extension" 
is then generated in words 60 thru 67. The resulting ACB thus has the 
following format: 
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It 5 6 7 8 9 10 11 12 13 lU 15 



2 
3 



10 
11 
12 
13 
Ik 

15 
16 
17 
18 

19 
20 
21 
22 
23 
2k 

25 
26 



Complete ACB size 







File number 




File name 


- 1st char. 


File name - 2nd char. 




File name 


- 3rd char. 


File name - Uth char. 




File name 


- 5th char. 


File name - 6th char. 


File name 


- 7th char. 


File name - 8th char. 





FOPTIONS 



AOPTIONS 



Record size in bytes 



Block size in words 



(Reserved for PACBV, if multi-access) 



Carriage control code 



|EOF|Pg |Ln |St |FK |TC |TB |8B |Car|DB | EOF T | EOF M | 



| TE| IC| Q 



| Terminal stop character 



Error code 



Last I/O transmission log 



File pointer 



Current variable block number 



Record transfer count 



Block transfer count 



Highest block number started 



FCB Vector 



2 
3 



10 
11 
12 
13 

Ik 

15 
16 

17 
20 
21 
22 
23 
2k 

25 
26 

27 

30 
31 
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27 
28 

29 
30 
31 
32 
33 
3k 
35 
36 
37 
38 

39 
1*0 

in 

1+2 

U3 
itU 

k5 

k6 
kl 



Spare 


Mo. input LACB'S 


| Total no. LACB'S 


|Bk | Device type 


| Last logical I/O status 


AE |RW |ABR|NE | SEOFS | ] 


SOFS | Blocking factor 


PF |Hit| | Current buffer | Tape Displace.! No. buffers 


Current 


record word index 


Buffer size 


Spare 


FMAVT index 


Volume table index 


Name type 


| File disposition 


Access bit map 


| Logical device number 


S | M | Q | R | D | 


| Virtual logical device no. 


Spooled device type | 


Spooled device record size 


Spooled 


device FOPTIONS 


Spooled 


device AOPTIONS 


IDD 


or ODD Index 



No-Wait disk address 



Spare 
Spare 



33 
3k 

35 
36 

37 
1+0 
kl 
1*2 
k3 
1+1+ 

U5 
1+6 
kl 
50 
51 
52 
53 
5k 
55 
56 
57 



The above words, 0-Ji57» are physically located in the PACB of 
the file. Below, words %60-%67, are used by file system intrin- 
sics and are placed onto the stack by the procedure LOC'ACB when 
locking the ACB. Therefore, the buffering extention, if pres- 
ent, will immediately follow word %57 of the actual ACB in the 
Control Block Table of the file. 

+ + 

1+8 | PACB DST nr. I 60 

| | 

1+9 | PACB offset (DST-rel.) I 6l 
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50 

51 
52 
53 
51* 
55 



LACB DST nr. 



LACB offset (DST-rel. ) 
ACB offset (Stack-DST-rel.) 



DB offset (Stack-DST-rel.) 
Stack-DST-rel location of PXFILE CBTAB 
CBTAB-rel vector table entry address 



62 

63 
6k 

65 
66 

67 



The following identifiers are used when referring to an ACB: 



(ACBSIZE) 

ACBFNUM 

ACBNAME 

ACBNAME1 

ACBNAME2 

ACBFOPTIONS 

ACBAOPTIONS 

ACBRSIZE 

ACBBSIZE 

ACBCTL 

ACBLSTATE 

ACBEOF 

ACBLPCTL 

ACBPAGECTL 

ACBLINECTL 

ACBSTREAM 

ACBFKEYS 

ACBXMITCRLF 

ACBTBLOCK 

ACBBINARYIO 

ACBCARRIAGE 

(ACBDEFBLOCK) 

ACBREADCODE 

ACBREADTYPE 

ACBREADMODE 

ACBMODW 

ACBMODE 

ACBTAPEERROR 

ACBINHIBCRLF 

ACBQUIESCE 

ACBSTOPCHAR 

ACBERROR 

ACBTLOG 

ACBFPTR 

ACBBLK 



ACB.(2:llt)#, 

ACB(1).(8:8)#, 

ACB(2)#, 

ACBDBL(1)#, 

ACBDBL(2)#, 

ACB(6)#, 

ACB(7)#, 
ACB(8)#, 
ACB(9)#, 



first half 
second half 



= ACB(11)#, 
= ACB(12)#, 
= ACBLSTATE. 
= ACBLSTATE. 
= ACBLSTATE. 
= ACBLSTATE. 
= ACBLSTATE. 
= ACBLSTATE. 
= ACBLSTATE. 
= ACBLSTATE. 
= ACBLSTATE. 
= ACBLSTATE. 
= ACBLSTATE. 
= ACBLSTATE = 
= ACBLSTATE. 
= ACBLSTATE. 



(1:1)#, 
(2:2)#, 
(2:1)#, 
(3:D#, 
(^:1)#, 
(5:D#, 
(6:1)*, 
(7:D#, 
(8:1)#, 

(9:D#, 

(10:1)#, 

(11:U)#, 

(11:2)#^ 

(13:2)#; 



ACBMODW. (0:8)#, 
ACBMODW. (1+:1)#, 
ACBMODW. (5:1)#, 
ACBMODW. (6:1)#, 
ACBMODW. (8:8)#, 
ACB(lU)#, 
ACB(15)#, 
ACBDBL(08)#, 
ACBDBL ( 09 ) # , 



size in words 
file number 
file name 
file name 
file name 
FOPTIONS 
AOPTIONS 

record size (bytes) 
block size (words) 

carriage control word 

local state flags 

end of file sensed 

page and line control 

page control 

line control 

stream I/O 

restore function keys 

transmit CR,LF to user 

disable block mode 

8 -bit terminal transfers 

carriage control flag 

default blocking 

input EOF check 

input EOF type 

input EOF mode 

mode word 

mode setting 

report recovered tape error 

inhibit terminal CR/LF 

critical output verify 

terminal stop character 

error code 

last I/O transmission log 

current record number 

current variable block 
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ACBRTFRCT 
ACBBTFRCT 
ACBHIBLK 
ACBFCB 

ACBSHCNTS 

ACBSHCNTIN 

ACBSHCNT 

ACBSTATW 

ACBBREAK 

ACBDTYPE 

ACBACCCL 

ACBSUBCL 

ACBSTATUS 

ACBQSTATUS 

ACBGSTATUS 

ACBGSTW 

ACBNOWAITEOF 

ACBNOWAITMODE 

ACBABORTREAD 

ACBNEWEOF 

ACBSAVEEOFS 

ACBEOFS 

ACBBLKFACT 

ACBBUFX 

ACBFRIV 

ACBHIT 

ACBCURRBUF 

ACBTAPEDISP 

ACBNUMBUFS 

ACBBUFUSED 

ACBBUFSIZE 

ACBXXXX 

ACBFMAVTX 

ACBVDADDR 

ACBDNTD 

ACBDNTYPE 

ACBDISP 

ACBAMLD 

ACBACCESS 

ACBDADDR 

ACBSPFL 

ACBSPOOLED 

ACBSPOOLIO 

ACBSPSQ 

ACBSPSQZ 

ACBSPRSQ 

ACBSPDSQ 

ACBSPVDEV 

ACBSPTYRC 

ACBSPTYPE 

ACBSPREC 

ACBSPFOPT 

ACBSPAOPT 



= ACBDBL(10)#, 
= ACBDBL(11)#, 
= ACBDBL(12)#, 
= ACB(26)#, 

= ACB(28)#, 
= ACBSHCNTS. (0: 8) #, 
= ACBSHCNTS. (8 :8)#, 
= ACB(29)#, 
= ACBSTATW. (1:1)#, 
= ACBSTATW. (2:6)#, 
= ACBSTATW. (2: 3)#, 
= ACBSTATW. (5:3)#, 
= ACBSTATW. (8:8)#, 
= ACBSTATW. (8: 5)#, 
- ACBSTATW. (13: 3)#, 
= ACB(30)#, 
= ACBGSTW. (0:1)#, 
= ACBGSTW. (1:1)#, 
= ACBGSTW. (2:1)#, 
= ACBGSTW. (3:1)#, 
= ACBGSTW. (U:2)#, 
= ACBGSTW. (6 :2)#, 
• ACBGSTW. (8:8)#, 
= ACB(3D#, 
= ACBBUFX. (0:1)#, 
= ACBBUFX. (1:1)#, 
= ACBBUFX. (U:U)#, 
: ACBBUFX. (8:8)#, 
= ACBBUFX. ( 12 :U)#, 
' ACB(32)#, 
' ACB(33)#, 
: ACB(3U)#, 
■■ ACB(35)#, 
■■ ACB(36)#, 
= ACB(37)#, 
= ACBDNTD.(0:8)#, 
' ACBDNTD.(8:8)#, 
: ACB(38)#, 
' ACBAMLD. (0:8)#, 
' ACBAMLD. (8:8)#, 

: ACB(39)#, 

: ACBSPFL. (0:1)#, 
ACBSPFL. (0:2)#, 

■■ ACBSPFL. (2 :2)#, 
ACBSPFL. (2:1)#, 
ACBSPFL. (3:1)#, 
ACBSPFL. (U:l)#, 
ACBSPFL. (8:8)#, 

■■ ACB(U0)#, 
ACBSPTYRC. (0: 6) #, 
ACBSPTYRC. (6: 10) #, 
ACB(Ul)#, 
ACB(l42)#, 



logical record tfr count 
block transfer count 
highest block started 
FCB vector 

LACB counts 

# of Read LACB'S 

# of LACB'S 

access class, status, etc. 

break ($STDIN/LIST only) 

device type 

device access class 

device sub-class 

last logical I/O status 

qualifying status part 

general status part 

global state flags 

EOF advanced? 

last I/O: = read, 1 = write 

abort broken re-read? 

EOF advanced - tape file 

for saving ACBEOFS 

EOF flags - :E0D/: 

records /block 

buffer data & misc. flags 

privileged access only 

buffer hit flag 

current buffer nr. 

tape displacement 

number of buffers less 1 

used block word count 

buffer size (words) 

spare 

FMAVT index 

volume table index 

type & disposition 

name type for dir. search 

file disposition 

access mask & LDEV 

access mask 

logical device number 

spool control flags 
spooled device flag 
spooled IN/OUT 
squeeze flags 
file squeezed 
request to sqz 
squeeze just done 
spooled virtual device 
spooled dev type/recsize 
spooled dev type 

spooled dev rec size 
spooled dev FOPTIONS 
spooled dev AOPTIONS 
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ACBSPXDDX = ACB(U3)#, 
ACBNOWAITDA = ACBDBL(22)#, 
ACBNOWAITLDEV = ACB(27)#, 



IDD/ODD index 
No-wait disk address 



Discussion: 
ACBABORTREAD 



ACBACCCL 



ACBACCESS 



ACBAOPTIONS 
ACBBINARYIO 

ACBBLK 

ACBBLKFACT 

ACBBREAK 



This flag is used to abort a broken terminal re-read. 
The flag is set via the ABORT parameter to FUNBREAK. 
If the flag is set then the READ PENDING message will 
be aborted along with the re-read. This feature is 
needed to handle the BREAK. .. : ABORT, etc. situation. 

This is the access class part of the device type 
number. The following are legal values: 

- direct (e.g. disc) 

1 - serial input (e.g. card reader) 

2 - parallel input/output (e.g. terminal) 

3 - serial input/output (e.g. mag tape) 
h - serial output (e.g. line printer) 

This is the access bit map for the file. The following 
are the bit definitions of this eight-bit field: 



(0:1) 


- unused 


(1:1) 


- unused 


(2:1) 


- read 


(3:1) 


- append 


(U:l) 


- write 


(5:D 


- lock 


(6:1) 


- execute 


(7:1) 


- save 



This access security is determined by the 
intrinsic and enforced by the file system. 



ACCCHECK 



This is the AOPTIONS in effect for this file access. 

This bit controls full eight bit transfers on the 26UU 
page mode terminal. It is adjusted by FCONTROL ( 26 ) and 
FCONTROL(27). 

This is the block number of the current variable record 
format block. Applicable iff the record format is 
variable . 

This is the blocking factor for the file. It is the 
number of records in a block. Legal values range from 
1 to 255- 

This is the break mode flag. It is applicable iff the 
ACB is for $STDIN or $STDLIST. If set it means that 
the BREAK key has been hit and that the CI should have 
high priority access to the ACB. The flag will be 
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cleared when a RESUME or ABORT is issued. 



ACBBSIZE 
ACBBTFRCT 



This is the block size, in words, of the file. 

This is the total number of blocks transferred to and 
from the file. The initial value is OD. 



ACBBUFUSED 



ACBCARRIAGE 



ACBCTL 



ACBCURRBUF 



This is the word index, relative to the base of the 
block, for the selected record within the block. This 
is applicable iff the file access is buffered. 

This bit signifies that the file has carriage control. 
It is the same as the carriage control bit in 
ACBFOPTIONS if the file is spooled. If not spooled, 
the bit is zero, and IOMOVE will pass the FWRITE 
carriage control parameter directly to the driver 
rather than imbedding it as the first character of the 
output record. 

This is the CONTROL parameter from the last FWRITE. 
This value is pertinent iff the file was opened with 
carriage control. 

This is the buffer number (Q-relative) containing the 
most recently referenced record. Applicable iff the 
file access is buffered. 



ACBDADDR 



This is the logical device number of the file. For a 
disc file this is the logical device number of the 
first extent. 



ACBDEFBLOCK 



This bit signifies that the file is to be accessed with 
default blocking. The bit is initialized from the 
FOPEN stateword STATE. It does not need to be in the 
ACB; it is mentioned here only to signify that the bit 
is effectively used due to the way ACBLSTATE is 
initialized from STATE. 



ACBDISP 



ACBDNTYPE 



This is the file close disposition derived from the 
FOPEN call. The only way this can be specified is via 
a file equation. The legal values are the same as 
those for FCLOSE. 

This is the file reference format type number and is 
derived from the FOPEN call. The following are legal 
values : 



- full name 

1 - account name absent 

2 - group and account name absent 

3 - null name 



ACBDTYPE 



This information is needed by FRENAME. 

This is the device type number of the file, 
following are legal values (octal) : 



The 
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- moving head disc 

1 - fixed head disc 
7 - foreign disc 

10 - card reader 

11 - paper tape reader 
20 - terminal 

2k - card reader/ interpreter/punch 

26 - SSLC 

27 - programmable controller 

30 - magnetic tape 

31 - serial disc 
U0 - line printer 
Ul - card punch 

k2 - paper tape punch 
1*3 - CALCOMP 500 plotter 
kk - CALCOMP 600 plotter 
1*5 - CALCOMP 700 plotter 



ACBEOF 
ACBE0FS 



This bit is set when EOF has been sensed. 

This is the type of EOF detected on $STDIN(X), 
field consists of two bits: 



This 



(0:1) - super colon (i.e. EOF for $STDINX) 
(1:1) - regular colon (i.e. EOF for $STDIN) 

Applicable for multi-access to $STDIN(X) only. 



ACBERROR 



This is the error number for the file. It is used by 
all intrinsics except FOPEN. When an error is detected 
the error number is placed in this cell. The error 
number is cleared at the beginning of each callable 
intrinsic except FCHECK (which reads it). 



ACBFCB 



This is the FCB vector for the file. 
to disc files. 



Applicable only 



ACBFKEYS 



This bit controls the definition of the fl and f2 
function keys on the 26UU page mode terminal; it is 
adjusted by FCONTROL(32) and FCONTROL(33) . (Obsolete 
function) 






calling routines that access things such as labels by 
file number. 



a-P-P ***■»+ -Prt-r* 4-K4e filfl anr*ae< 



ACBFPTR 



This is the sequential access record pointer; it 
contains the next sequential record number. The 
initial value is 0D. This value is used only by the 
FREAD, FWRITE and FUPDATE intrinsics. However the 
value is maintained by all data transferring file 
system intrinsics. 
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ACBFMAVTX 



This is the entry index into the file 
vector table (FMAVT). This is valid 
access is multi-access. 



multi-access 
iff the file 



ACBGSTATE 



ACBGSTATUS 



These are miscellaneous state flags. These are 
"global" in nature in that they are the same for all 
accessors in a multi-access environment. The 
constituent bits are described individually. 

This is the general part of the last I/O status for the 
file. The following are the legal values: 

- pending 

1 - successful 

2 - end of file 

3 - unusual condition 

U - irrecoverable error 



ACBHIBLK 



This is the highest block number for which an 
anticipatory read has been issued, and is applicable 
iff the file access is buffered. The initial value is 
-ID. 



ACBHIT 



ACBINHIBCRLF 



ACBLINECTL 



ACBLPCTL 



ACBLSTATE 



This is the buffer hit flag. If set it indicates that 
the last read or write request was serviced without any 
physical I/O required. This flag is used only for 
performance measurement. The code which manipulates it 
is optional to the file system, and is controlled by 
compiler toggle X3» 

This bit controls the termination of lines written to 
the terminal. If not set then each line is terminated 
with a CR and LF; if set then no line termination 
characters are used. This bit is valid iff the file is 
a terminal file; it is adjusted by FSETMODE. 

This is the line control bit. If not set then each 
line is post-spaced; if set then each line is 
pre-spaced. This bit is used by line printers and 
terminals only. It is adjusted by FCONTROL(l) and 
FWRITE with the appropriate carriage control. 



This are the line and 
described separately. 



page control bits, which are 



These are miscellaneous state flags. They are "local" 
in nature in that they may be different for each 
accessor in a multi-access environment. Bits (9:6) are 
initialized from the stateword local variable called 
STATE in FOPEN; the ten remaining bits are initialized 
individually. The constituent bits are described 
individually. 
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ACBMODE 



ACBNAME 



ACBNEWEOF 



ACBNOWAITEOF 



ACBNOWAITMODE 



These are miscellaneous mode flags, 
bits are described individually. 



The constituent 



This is the local file name. The name is 
in length with trailing blanks added. 



eight bytes 



This flag when set indicates that a new tape mark 
should be written before the tape is rewound or 
backspaced. Applicable only to mag tape files. 

This bit is used to save the value of the local EOF 
advanced flag NEWEOF in IOMOVE between the I/O 
initiation and I/O completion calls. This flag is 
applicable iff the file is accessed in no-wait I/O 
mode. 

This cell is used to save the I/O mode between no-wait 
I/O initiation and completion calls. If the bit is set 
then the last I/O request was a write; otherwise it was 
a read. This cell is pertinent iff the file is 
accessed in no-wait I/O mode. 



ACBNUMBUFS This is the number of buffers, less one, used for the 
file access. Applicable iff the file access is 
buffered. 



ACBPAGECTL 



ACBPRIV 



ACBQSTATUS 



ACBQUIESCE 



ACBREADCODE 



ACBREADMODE 



This is the page control bit. If not set then a page 
is assumed to consist of 60 lines (auto page eject); if 
set then a page is assumed to consist of 66 lines (no 
auto page eject). This is used primarily for line 
printers but is also valid for terminals; these are the 
only devices for which this is valid. This bit is 
adjusted by FCONTROL(l) and FWRITE with the appropriate 
carriage control. 

This flag when set indicates that the file is 
privileged in that it has a negative file code; the 
user must be in privileged mode to access it. 

This is the qualifying part of the last I/O status for 
the file. The values are unique for each general 
status part. See I/O System IMS for all legal values. 

This bit controls critical output verification. If 
set, buffered output is guaranteed to have been written 
to the device when control is returned to the user. 



TTH . l.l|IHfSVTXT?> 



xms Dii. is aajU5T,ea t>y r cuLAnuuci. 

This field consists of the input EOF checking type and 
mode, and is used to generate the Fl parameter to 
ATTACHIO. These fields are described individually. 

This field controls the input EOF checking mode. It is 
00 for reading $STDIN, 01 for reading $STDINX, and 10 
for the command interpreter. 
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ACBREADTYPE 

ACBRSIZE 
ACBRTFRCT 

ACBSAVEEOFS 

ACBSHCNT 

ACBSHCNTIN 



This field controls the input EOF checking type. It is 
01 for JOBs, 10 for SESSIONS, and 00 for DATA. 

This is the file's record size in positive bytes. 

This is the total number of records transferred to and 
from the file. The initial value is 0D. 

This field is used to save the contents of ACBEOFS 
during BREAK mode processing. 

This is the total number of LACBs that exist for this 
PACB. Valid iff the file access is multi-access. 

This is the total number of input -only LACBs that exist 
for this PACB. Valid iff the file access is 
multi-access. 



ACBSHCNTS This is the total LACB and total input -only LACB 
counts, each of which is described separately. 

ACBSIZE This is the size, in words, of the complete ACB. It 
includes the buffering extension, if present. 

ACBSPAOPT This is the AOPTIONS for the spooled device. 
Applicable iff the file access is to a spooled device. 

ACBSPFOPT This is the FOPTIONS for the spooled device. 
Applicable iff the file access is to a spooled device. 

ACBSPOOLED This is the spooled device flag. If set then the file 
access is to a spooled device. 

ACBSP00LI0 This field is a combination of the spooled device flag 
and the input /output mode of the spooled device. Legal 
values are: 



ACBSPREC 



ACBSPTYPE 



00 - not spooled 

01 - illegal 

10 - input spooling 

11 - output spooling 

This is the record size, in bytes, of the spooled 
device. Applicable iff the file access is to a spooled 
device. 

This is the device type (from the LDT) of the spooled 
device. Applicable iff the file access is to a spooled 
device. 



ACBSPTYRC 



ACBSPVDEV 



This cell contains the spooled device type and record 
size, which are described separately. 

This is the logical device number of the spooled 
device. Applicable iff the file access is to a spooled 
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device. 

ACBSPXDDX This is the index into the IDD or ODD for a spoolfile. 
Applicable iff the file access is to either a spooled 
device or a spoolfile. 

ACBSTATUS This is the last I/O status for the file. It comes 
from the I/O status part of the IOCB returned by 
ATTACHIO. Not all ATTACHIO calls update this cell. 

ACBSTOPCHAR This is the record termination character used for 
terminal reads. This character can be changed via 
FCONTROL(25). 

ACBSTREAM This bit signifies inter-block garbage for disc files. 
If set, the block size is a multiple of 128 words and 
therefore there is no garbage data between blocks. 
This fact is used to improve multi-record I/O by 
mapping the request into as few ATTACHIOs as possible. 

ACBSUBCL This is the sub-class part of the device type number. 
The sub-class is unique for each access class. The 
following are the legal sub-class values for each 
device class: 

- direct 

- moving head disc 

1 - fixed head disc 
7 - foreign disc 

1 - serial input 

- card reader 

1 - paper tape reader 

2 - parallel input/output 

- terminal 

k - card reader/punch 

6 - SSLC 

7 - programmable controller 

3 - serial input /output 

- mag tape 
7 - serial disc 
k - serial output 

- line printer 

1 - card punch 

2 - paper tape punch 

3 - CALCOMP 500 plotter 
k - CALCOMP 600 plotter 
5 - CALCOMP 700 plotter 

ACBTAPEDISP This number is used to keep track of the difference or dis- 
placement between the physical and logical tape locations. The 
tape could be mispositioned due to pre-reads and this variable 
is used to properly backspace the tape before an FWRITE, 
FSPACE, FC0NTR0L(6) or FCL0SE(DISP=3) • 
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ACBTAPEERROR 



ACBTBLOCK 



This bit controls the reporting of recovered mag tape 
errors. If not set the recovered errors are not 
reported to the user; if set then recovered errors are 
reported to the user by returning CCL and error number 
39- Valid iff the file is a mag tape file. This bit 
is adjusted by FSETMODE. 

This bit controls block mode transfers on the 26kk page 
mode terminal. This bit is adjusted by FCONTROL ( 28 ) and 
FCONTROL(29). 



ACBTLOG 



This is the last I/O transmission log for the file. It 
comes from the I/O transmission log part of the IOCB 
returned by ATTACHIO. Not all ATTACHIO calls update 
this cell. 



ACBVDADDR 



This is the volume table index for 
Applicable iff the file is a disc file. 



the file . 



ACBXMITCRLF 



This bit controls CR and LF insertion into the user 
buffer on the 26kk page mode terminal. This bit is 
adjusted by FC0NTR0L(30) and FCONTROL ( 31 ) . 
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If present, the PACB buffering extension contains from one to sixteen 
block buffers each having the following format: 



7 10 11 12 13 14 15 
IOQ entry index 



|U|R|D|W|M|P 
IOCB - Status 
IOCB - Transmission log 



Block number 



Block log. 


device no . | 


Block sector number 


Block Extent Base 


Block Extent Size 


Not Used 



Buffer 



BLKIOQX 

1 BLKFLAGW 

2 BLKLSTAT 

3 BLKTLOG 
U BLKBLOCK 

5 

6 BLKDADDR 

7 

8 BLKEXTBASE 

9 

10 BLKEXTSIZE 

11 

12 BLKBUFFER 



Other identifiers used: 



BLKIOCB 


= BLKDBL(1)#, 


(BLKLDEV) 


= BLK(6) 


.(0:8)#, 


BLKFLAGS 


= BLK(l) 


.( 8:8)#, 


BLKUNALLOCEXT 


= BLK(l) 


.(10:1)#, 


BLKREVERSE 


= BLK(l) 


.(11:1)#, 


BLKDONTWAIT 


= BLK(l) 


.(12:1)#, 


BLKIOOUT 


= BLK(l) 


.(13:D#, 


BLKDIRTY 


= BLK(l) 


.(lU:l)#, 


BLKIOPEND 


= BLK(l) 


.(15:D#, 


BLKIOCOMP 


= BLK(l) 


.(1U:2)#, 



IOCB 

block logical device number 

block I/O flags 

block from un-allocated extent 

block for tape FREADBACKWARDS 

I/O status not checked. 

last I/O was write? 

buffer modified? 

I/O in progress? 

I/O complete - not dirty 
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Discussion: 
BLKBLOCK 

BLKBUFFER 

BLKDADDR 
BLKDIRTY 



BLKDONTWAIT 



This is the block number of the data contained in the 
buffer. A value of -ID indicates that the buffer is 
empty . 

If ACB buffering is used, this is the buffer location. 
When system buffers were used, the buffer location was 
given by BLKSYSBUFX and BLKSYSBUFDISP. 

This is the block's logical device and sector number. 

This flag is set if the contents of the buffer has been 
modified. When the block buffer is reused this flag is 
checked to see if the block needs to be written to the 
device. 

This bit is on if the buffer's I/O was completed and the 
BLKIOQX and pending bits cleared, but the status of the I/O was 
not checked. This is done to free valuable DRQ entries. If 
the bit is on, then BLKLSTAT must be checked before using the 
block. 



BLKEXTBASE 



BLKEXTSIZE 



BLKFLAGS 



BLKIOCB 



BLKIOCOMP 



BLKIOOUT 

BLKIOPEND 

BLKIOQX 

BLKLDEV 



This is the sector address of the base of the extents in 
the block resides. It is used for I/O disk caching. 



which 



This is the size, in sectors, of the extent in which the block 
resides. Also used for I/O disk caching. 



These are the miscellaneous flags associated 
block, which are described separately. 



with 



the 



This is the IOCB returned by the I/O system when the 
block I/O has completed. On a blocked I/O request this 
is obtained from the ATTACHIO call; on an unblocked I/O 
request this is obtained from WAITFORIO. 

This is the buffer modified flag (BLKDIRTY) and the I/O 
in progress flag (BLKIOPEND), which are described 
separately. This field is usually interrogated to see 
if it contains the value 2, which means that the buffer 
has been modified but not yet written to the device. 



This is the mode of the I/O operation for the 
It is set by a write and cleared by a read. 



block. 



This is the I/O in progress flag. It is set if the I/O 
is pending; it is cleared when the I/O has completed. 

This is the IOQ index of the unblocked I/O request for 
the block. It is used as the argument to WAITFORIO, 
which insures the completion of the I/O request. 

This is the logical device number of the block. 
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BLKLSTAT 



BLKREVERSE 



BLKTLOG 



BLKUNALLOCEXT 



The I/O status part of the IOCB consists of the PCB 
number and the error code for the completed I/O 
request . 

This bit is not currently used but has been reserved 1 
FREADBACKWARDS (reading a tape backwards) to a buffered fi] 
which is not currently supported. 

The transmission log part of the IOCB is the number of 
words or bytes transferred by the the I/O request. 

This bit is on if the block in this buffer was read from 
unallocated extent. In this case, the extent was not allocal 
and the buffer was simply flushed with fill characters. 1 
block must be allocated before writing to i 
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3.2.7 File Control Block (FCB) 



The FCB coordinates access to a file on a sharable device. At present 
the only sharable device is a disc, so only disc files have FCBs. 

The information contained in an FCB is derived from the file label. The 
FCB is used to hold this information, rather than the file label, since 
it can be accessed more quickly. 

The FCB can be contained in a stack when first created. If another 
process opens the file, the FCB will be moved to a system data segment 
(which will be created if it doesn't already exist) so that the first 
process' entire stack need not be present when the second process is 
dealing with the file. The number of a data segment containing a list 
of numbers of shared file system data segments is kept in system global 
location 1076 octal. The size of the FCB depends on the maximum number 
of extents specified at FOFEN; there are kk (octal) words plus two per 
extent. There will be at least one extent, since the file label always 
exists in the first extent. The FCB extent map is in terms of logical 
device and sector number. The extent map in the file label is in terms 
of volume rather than logical device; the map is converted by VTABTOLDEV 
when the label is read, and converted back by LDEVTOVTAB when the label 
is written to disk. 

The FCB has the following format: 



12 3 



7 8 12 13 lU 15 






1 1 


1 


Complete FCB size 






1 

1 
2 
3 

5 

6 

7 
10 
11 

12 
13 




1 


1 New FCB vector 


FCBNEWFCB 


2 


FOPTIONS 


FCBFOP- 


3 


Device specification 


TIONS 
FCBDEVICE 


U 


Prev 


. lock 


Dev. type | C | | Device 


subtype 




5 


No. 


opens 


for output | No. opens for 


any 


mode 




6 


Creator ACB vector 


FCBACB 


7 


RIN number 


FCBRIN 


8 


Exclusive status 


FCBEXC- 

STAT 

FCBPVINFO 


9 I 


Private volume information 


10 | 

11 | 


File limit 


FCBFLIM 
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12 | 

13 1 




Reserved for IMAGE 




Ik 

15 
16 

17 
20 
21 
22 

23 
2k 

25 
26 

27 
30 
31 
32 
33 
3k 

35 
36 
37 

! 40 
1 kl 
| k2 
1 U3 
| kk 
1 k5 


FCBIMAGE 


Ik | 
15 1 


End of data pointer I 


FCBEOF 


16 I 


No. user labels written | 


No. user labels 


avail, j 


FCBUSERLBL 


17 1 


Extent size in sectors I 


FCBEXTSIZE 


18 I 


Blockin 
Sector offs 


g factor | 


Sectors per block | 




19 1 


et to data | 


Disp | No. extents - 1 | 




20 ! 


Last extent size in sectors 


FCBLAST- 
EXTSIZE 


21 ! 




1 


No. opens input 


mode 




22 


Group name 


- 1st char. | 


Group name - 2nd 


char . 


FCBGN 


23 


Group name 


- 3rd char. | 


Group name - Uth 


char. 




2k 


Group name 


- 5th char. | 


Group name - 6th 


char. 




25 


Group name 


- 7th char. | 


Group name - 8th 


char. 




26 


Acct name 


- 1st char. | 


Acct name - 2nd 


char. 


FCBAN 


27 


Acct name 


- 3rd char. | 


Acct name - Uth 


char. 




28 


Acct name 


- 5th char . | 


Acct name - 6th 


char. 




29 


Acct name 


- 7th char. | 


Acct name - 8th 


char. 




30 

31 




Start of file 


block number 




FCBSTART 


32 
33 


! Current 


; number of data blocks in the file 


FCBEND 


3k 
35 


! Number of 


open and close 


records (message 


file) 


FCBNUM- 
OPENCLSREC 


36 


j Logical device number | 


sector number 




FCBEXTMAP 


37 




First extent 








• 
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I Logical device number | 
I— - 

I Last extent sector number 

Other identifiers used: 



FCBSIZE 

FCBLKST 

FCBDTYPE 

FCBCRUNCH 

FCBSUBTYPE 

FCBOCNTOUT 

FCBOCNT 

FCBLBLEOF 

FCBLBL 

FCBBLKFACT 

FCBSECTPBLK 

FCBSECTOFF 

FCBDISP 

FCBNUMEXTS 

FCBOCNTIN 

FCBLABEL 

FCBLDEV 



FCB.(2:llt)#, 

FCB(U).(0:2)#, 

FCB(lt).(2:6)#, 

FCB(lt).(8:l)#, 

FCB(U).(12:U)#, 

FCB(5).(0:8)#, 

FCB(5).(8:8)#, 

FCB(l6).(0:8)#, 

FCB(l6).(8:8)#, 

FCB(18).(0:8)#, 

FCB(l8).(8:8)#, 

FCB(19).(0:8)#, 

FCB(19).(8:3)#, 

FCB(19).(11:5)#. 
FCB(21).(8:8)#, 
FCBDBL(18)#, 
FCB(36).(0:8)#, 



size in words 

previous lock state 

device type 

pending crunch disposition 

device subtype 

no. accessors - output 

no. accessors 

no. labels written 

no. labels available 

blocking factor 

sectors per block 

sector offset to data 

pending disposition 

no. extents less 1 

no. acccessors - input 

label LDEV and sector 

label LDEV 



Discussion: 
FCBACB 

FCBAN 
FCBBLKFACT 

FCBDEVICE 



FCBDISP 



This is the vector of the ACB that was created at the 
same time as the FCB. This is used in conjunction with 
FCBNEWFCBV when relocating the FCB. 

This is the account name of the file. It is eight 
bytes in length with trailing blanks added. 

This is the blocking factor of the file. It is the 
number of logical records in a physical block. Legal 
values range from 1 to 255- 

This specifies the device on which the file resides. 
If it is positive then it represents a logical device 
number; if negative it represents a (negative) device 
class index. 

This is the pending FCLOSE disposition for the file. 
Legal values are: 

- no change 

1 - save permanent 

2 - save temporary and rewind 

3 - save temporary but do not rewind 
k - release 
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FCBCRUNCH 



7 - invalid file (file label access error) 

This bit governs if space will be returned beyond the EOF U] 
the last FCLOSE of the file. 

- no change 

1 - return space beyond EOF 



FCBDTYPE 

FCBEND 
FCBEOF 



FCBEXCLSTAT 



FCBEXTMAP 



FCBEXTSIZE 



FCBFLIM 



FCBFOPTIONS 
FCBGN 

FCBLABEL 
FCBLASTEXTSIZE 



This is the device type number of the first extent of 
the file. See ACBDTYPE for a list of legal values. 

Block number of the file's EOF, relative to FCBSTART. 

This is the end-of-file pointer for the file. It is a 
double integer representing the number of records in 
the file. It can also be viewed as the record number 
of the next record past EOF. 

This is the exclusive status of the file access. If -1 
then the file is being accessed exclusively; otherwise 
it is the number of semi-exclusive accessors. 

This is the extent map of the file. The number of 

extents is specified by FCBNUMEXTS; a OD extent 

descriptor indicates that the extent has not been 
allocated. 

This is the extent size, in sectors, of the file. All 
extents in the file except possibly the last have this 
size. This is a logical value, and legal values range 
from 1 to 65535 sectors. This restricts the maximum 
file size to 2097120 sectors (268,U31,360 words). 

This is the end-of -space pointer for the file. It is a 
double word integer representing the maximum number of 
records (fixed length record format) or blocks 
(undefined or variable length record format) in the 
file. 

This is the FOPTIONS in effect for the file. 



This is the group name of the file, 
long with trailing blanks added. 



It is eight bytes 



This is the logical device and sector number of the 
file label, which is the same as the first extent 
descriptor. 

This is the size, in sectors, of the last extent in the 
file. If the file has one extent then this is the same 
as FCBEXTSIZE; otherwise this value may be different 
from FCBEXTSIZE. This is the size of the last physical 
extent for the file; it is not the size of the last 
allocated extent. 
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FCBLBL 



This is the number of user labels allocated for the 
file. Since each label is a sector long, this is also 
the number of sectors allocated for user labels. 



FCBLBLEOF 



This is the end-of-data po inter for the user labels. 
It is analogous to FCBEOF in that it represents the 
number of labels written. The initial value is 0. 



FCBLDEV 



This is the logical device number of the first extent 
of the file. 



FCBLKST This is the previous lock state of the file and is 
derived from the file label. Legal values are: 

- no accessors 

1 - read 

2 - write 

3 - read/write 

FCBNEWFCBV This is the vector of the new FCB for the file. It is 
used in conjunction with FCBACB to move the FCB to a 
system (shared FCB) control block table when the second 
accessor is established. If this value is zero then 
there is no new FCB; if non-zero then a new FCB has 
been created. 

FCBNUMEXTS This is the maximum number of extents, less one, 
allowed for the file. It is not the number of extents 
presently allocated, which is always determined by 
counting non-zero entries in the extent map. 

FCBNUMOPENCLSREC Number of open and close records in the message file. 



FCBOCNT 



This is the number of accessors for the file. 
Alternatively it can be viewed as the number of PACBs 
created for the file. 



FCBOCNTIN 



This is the number of file accessors having input 
access. 



FCBOCNTOUT This is the number of file accessors having output 
access. 



FCBRIN 



This is the RIN number used to support dynamic locking 
(i.e. FLOCK and FUNLOCK) for the file. If there is no 
dynamic locking then this number is zero. 



FCBSECTOFF This is the sector offset from the file label to the 
first block of the file. This is not necessarily equal 
to FCBLBL+1 since an integral number of blocks are 
allocated for the file and user labels. 
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FCBSECTPBLK 
FCBSIZE 

FCBSTART 

FCBSUBTYPE 
FCBUSERLBL 



This is the number of sectors in a block for the file. 

This is the size, in words, of the complete FCB. It 
includes the extent map. 

Block number of the file's start, excluding the file 
label block. 

This is the device sub- type num\|»r of the first extent. 

This field describes the user labels for the file. It 
consists of FCBLBL and FCBLBLEOF, described separately. 
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3.3 File Label (FLAB) 



The file label has the following format: 



12 


3 


7 


8 12 


! 13 


lU 15 


| File name 


- 1st 


char. 


I File name 


- 2nd 


char. | 


I File name 


- 3rd 


char. 


| File name 


- Uth 


char . | 


I File name 


- 5th 


char. 


I File name 


- 6th 


char. | 


| File name 


- 7th 


char. 


I File name 


- 8th 


char. | 


| Group name 


- 1st 


char. 


I Group name 


- 2nd 


char. | 


I Group name 


- 3rd 


char. 


Group anme 


- Uth 


char . | 


| Group name 


- 5th 


char. 


Group name 


- 6th 


char . | 


| Group name 


- 7th 


char. 


Group name 


- 8th 


char . | 


I Acct name 


- 1st 


char. 


Acct name 


- 2nd 


char. | 


Acct name 


- 3rd 


char. 


Acct name 


- Uth 


char . | 


Acct name 


- 5th char. 


Acct name 


- 6th 


char. | 


Acct name 


- 7th char. 


Acct name 


- 8th 


char, j 


Creator name - 1st char. 


Creator name - 2nd char. j 


Creator name - 3rd char. 


Creator name - Uth char. j 


Creator name - 5th char. 


Creator name - 6th char. j 


Creator name - 7th char. 


Creator name - 8th char. j 


Lockword - 


1st char. | 


Lockword - 


2nd char. j 


Lockword - 


3rd char. | 


Lockword - 


Uth char. j 


Lockword - 


5th char. j 


Lockword - 


6th char. | 


Lockword - 


7th char. | 


Lockword - 


8th char. | 






Security 


matrix 






Reserved 




1 




1 


SR | S | 



FLLOCNAKE 

1 

2 

3 

U FLGRPNAME 

5 

6 

7 
10 FLACCTNAME 
11 
12 
13 
lU FLUSERID 

15 
16 

17 

20 FLLOCKWORD 

21 

22 

23 

2U FLSECMX 

25 

26 
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Creation date 
Last access date 



Last modification date 
File code 



FCB vector 
S | R | L | X | Subtype | Disc type | R/W 
No. user labels written | No. user labels avail. 



File limit in blocks 



^-V^^-vstv^-tf/^^-^-- 



Checksum 
Cold load ID 



FOPTIONS 
Record size in bytes 



Block size in words 
Sector offset | j No. extents -1 



Last extent size in sectors 
Extent size in sectors 



End of data pointer 



Volume table index | 

1st extent sector number 



Volume table index | 

Last extent sector number 



27 


FLCREATE 


30 


FLLASTACC 


31 


FLLASTMOD 


32 


FLFILECODE 


33 


FLFCBVECT 


3U 


FLLOCK 


35 


FLUSERLBL 


36 


FLFLIM 


37 




1*0 




1*1 




1*2 


FLCHECKSUM 


1*3 


FLCLID 


Ul* 


FLFOPTIONS 


1*5 


FLRECSIZE 


1*6 


FLBLKSIZE 


1+7 




50 


FLLASTEXT- 




SIZE 


51 


FLEXTSIZE 


52 


FLEOF 


53 




5U 


FLEXTMAP 


55 
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File allocation time 



File allocation date 



Start of file block number 



Block number of end of file 



Number of open and close records (message file) 



Device name - 1st char. | Device name - 2nd char. 
Device name - 3rd char. | Device name - Uth char. 



Device name - 5th char. | Device name - 6th char. 
Device name - 7th char. | Device name - 8th char. 



l$k FLALLOCTIME 

155 

156 FLALLOCDATE 

160 FLSTART 

161 

162 FLEND 

163 

16k FLNUMOPENCLSREC 

165 
174 FLDEVNAME 
175 
176 
177 



Other identifiers used: 



FLSECURE 


= FLAB(22) 


.(15:D#, 


(FLSRRELEASE)= FLAB (22) 


.(lU:l)#, 


(FLSTORE) 


= FLAB(28) 


.(0:1)#, 


FLRESTORE 


= FLAB(28) 


•(1:1)#, 


(FLLOAD) 


= FLAB(28) 


.(2:1)#, 


FLEXCL 


= FLAB(28) 


.(3:D#, 


FLSR 


= FLAB(28) 


.(0:2)#, 


FLSRL 


= FLAB(28) 


.(0:3)#, 


(FLSRLX) 


= FLAB(28) 


•(0:U)#, 


FLSUBTYPE 


= FLAB(28) 


. <U:i+>#, 


FLDTYPE 


= FLAB(28) 


(8:6)#, 


FLSTATUS 


= FLAB(28) 


(H»:2)#, 


(FLLBLEOF) 


= FLAB(29) 


(0:8)#, 


(FLLBL) 


= FLAB(29) 


(8:8)#, 


FLSECTOFF 


= FLAB(39) 


(0:8)#, 


FLNUMEXTS 


= FLAB(39) 


(11:5)#, 


FLLABEL 


= FLABDBL(J 


22)#, 


FLVTAB 


= FLAB(UU) 


(0:8)#, 



file secure bit 

STORE/RESTORE released bit 

file being stored 

file being restored 

file loaded 

exclusive access 

S fc R bits 

S, R, te L bits 

S, R, L, & X bits 

device sub -type 

device type 

write/read status 

no. labels written 

no. labels available 

sector offset to data 

no. extents less 1 

label VTAB and sector 

label VTAB index 
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Discussion: 
FLACCTNAME 

FLALLOCDATE 
FLALLOCTIME 

FLBLKSIZE 
FLCHECKSUM 



This is the account name of the file. It is eight 
bytes in length with trailing blanks added. 

Date that the file was allocated on this system. 

Doubleword containing the time that the file was 
allocated on this system. 

This is the block size, in sectors, of the file. 

This is the exclusive-OR checksum of the file label 
(excluding words 3 1 *, **2, and 1+3 octal) and is used for 
error detection. Each time the file label is read from 
disc the check sum is calculated and compared against 
the value recorded in the file label. Similarly, each 
time the file label is written to the disc the check 
sum is calculated and inserted into the file label. 



FLCLID 



FLCREATE 



FLDEVNAME 



This is the cold load number in effect the last time 
that the file was accessed. This should always be the 
current cold load number. If it is not it means that 
the system crashed while the file was open and that the 
data in the file label should be "reset" (principally 
the FCB vector FLFCBVECT) . 



This is the creation date of the file. It 
format defined by the intrinsic CALENDAR. 



is in the 



This is the FOPEN device specification that was used 
when the file was created. This information is needed 
when new extents are allocated. 



FLDTYPE 



FLEND 



FLEOF 



FLEXTMAP 



This is the device type number of the first extent of 
the file; see ACBDTYPE for a list of legal values. 
This value is determined by configuration. 

Number of current data blocks (that is, the end of file 
block number relative to the start of file). 



This is the end-of-file pointer for the file. 









It is a 

** a r* r\ T-/3 e» 

in the file. It can also be viewed as the record 
number of the next record past EOF. 

ITTUJ- J- 4-U- „.,~1,,„ •:.,,* „-.„„„„ «•-!».*. <•»«. +Um <P<i1«t T-P oo-t- 

it means that the file has been opened exclusively by a 
single accessor. If not set then the file is 
potentially accessible by others. 

This is the extent map of the file. The number of 
extents is specified by FLNUMEXTS; a OD extent 
descriptor indicates that the extent has not been 
allocated. 
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FLEXTSIZE This is the extent size, in sectors, of the file. All 
extents in the file, except the last, have this extent 
size. This is a logical value, and legal values range 
from 1 to 65535 sectors. This limits the maximum file 
size to 2097120 sectors. 

FLFCBVECT If non-zero, this is the vector of the FCB for the 
file. If zero, the file is not being accessed. 

FLFILECODE This is the file code of the file. Known values are: 

-U01 IMAGE data set 

-U00 IMAGE root file 

102U USL file 

1025 BASIC data file 

1026 BASIC program file 

1027 BASIC fast program file 

1028 RL file 

1029 Program file 

1030 STAR file 

1031 SL file 

10l»0 Cross Loader ASCII file (SAVE) 

lOUl Cross Loader relocatable binary file 

10i»2 Cross Loader ASCII file (DISPLAY) 

1050 EDITOR KEEPQ file (non-COBOL) 

1051 EDITOR KEEPQ file (COBOL) 
1060 RJE punch file 

1069 RSAM (Bob Strand's ISAM) file 

1070 QUERY procedure file 

1071 QUERY work file 

1072 QUERY work file 
1080 KSAM key file 
1081 

to Reserved for KSAM 
1089 
8000 

to Reserved for APL 
8099 

FLFLIM This is the end-of -space pointer for the file. It is a 

double integer representing the maximum number of 
records (fixed length record format) or blocks 
(undefined or variable length record format) in the 
file. 

FLFOPTIONS This is the FOPTIONS of the file. 

FLGRPNAME This is the group name of the file. It is eight bytes 
long with trailing blanks added. 

FLLABEL This is the volume table index and sector number of the 
file label, which is the same as the first extent 
descriptor. 

FLLASTACC This is the last access date of the file. It is in the 
format defined by the intrinsic CALENDAR. 
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FLLASTMOD 



FLLASTEXTSIZE 



This is the last modification date of the file. It 
in the format defined by the intrinsic CALENDAR. 



is 



This is the size, in sectors, of the last extent in the 
file. If the file has one extent then this is the same 
as FLEXTSIZE; if the file has more than one extent then 
this value may be different from FLEXTSIZE. This is 
the size of the last physical extent for the file; it 
is not the size of the last allocated extent. 



FLLBL 



This is the number of user labels allocated for the 
file. Since each label is a sector long, this is also 
the number of sectors allocated for user labels. 



FLLBLEOF 



This is the end-of-data pointer for the user labels. 
It is analogous to FLEOF in that it represents the 
number of labels written. 



FLLOAD 



FLLOCK 



FLLOCKWORB 



This is the LOADED flag for the file. If set it means 
that the file is a loaded program or SL file and cannot 
be modified except by a privileged accessor. This flag 
is set and cleared by the loader, not the file system. 



This identifies the word containing 
which are described separately. 



the lock bits, 



This is the lock word of the file. It is eight bytes 
long with trailing blanks added. If it is all blanks 
then the file does not have a lockword. 



FLLOCNAME This is the local name of the file. It is eight bytes 
long with trailing blanks added. 

FLNUMEXTS This is the number of extents, less one, allowed for 
the file. It is not the number of extents allocated. 
Legal values range from to 31 * i- e., 1 to 32 
extents . 

FLNUMOPENCLSREC Number of open and close records in the message file. 

FLRECSIZE This is the record size of the file in negative bytes. 



r bK&ca'UKJs 



FLSECMX 



inis is xne juioxunb ixag ior xne nxe. j.i sex m means 
that the file is being RESTOREd and cannot be accessed. 
RESTORE also sets the STORE bit for the file (FLSTORE); 
see FLSR for a full description of the use of these 
bits. This flag is set and cleared by STORE /RESTORE , 
not the file system. 

This is the security matrix of the file. 
The bits are organized into five groups of six bits 
each. (Bits 0:2 are not used.) The groups correspond 
to the access types: READ, APPEND, WRITE, LOCK, and 
EXECUTE. Within each group, each bit specifies who 
may have the access: ANY, ACCOUNT MGR, ACCOUNT LIB- 
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RARIAN, GROUP, GROUP LIBRARIAN, CREATOR. 



FLSECTOFF 



This is the sector offset from the file label to the 
first block of the file. This is not necessarily equal 
to FLLBL+1 since an integral number of blocks are 
allocated for the file and user labels. 



FLSECURE 



This is the file security enforcement flag for the 
file. If not set then the file has been RELEASEd and 
the security matrix FLSECMX should be ignored. If set 
then secured as specified by the security matrix. 



FLSR 



This is the STORE and RESTORE flags for the file, which 
are described separately. STORE and RESTORE decode the 
two-bit field to indicate their operation. Legal 
values are: 



- file not in use by either STORE or RESTORE 

1 - illegal value 

2 - file being STOREd 

3 - file being RESTOREd 



FLSRL 



FLSRLX 



FLSRRELEASE 



FLSTART 



The file system interprets the leftmost bit as 
indicating that the file is being accessed by either 
STORE or RESTORE. The rightmost bit is interpreted as 
indicating what access should be permitted: (file 
being STOREd) allows read access; 1 (file being 
RESTOREd) allows no access. This field is set and 
reset by STORE /RESTORE, not the file system. 

This is the STORE, RESTORE and LOADED flags for the 
file, which are described separately. 

This is the STORE, RESTORE, LOADED and exclusive flags 
for the file, which are described separately. 

This flag is used by STORE /RESTORE . If a file is 
STOREd with the ";RELEASE" keyword, STORE will set this 
flag in the tape copy of the file label. RESTORE will 
allow any user to access such files, regardless of the 
file's normal security. If this bit is off in the tape 
copy of the file label, RESTORE applies normal security 
checks (as defined by the information in FLSECMX and 
FLSECURE). This bit is zero for files on disc. 



Block number of the file's start, 
label block. 



excluding the file 



FLSTATUS 



This is the read/write status of the file. Legal 
values are: 



- no accessors 

1 - read 

2 - write 

3 - read/write 
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FLSTORE 



This is the STORE/RESTORE flag for the file. If set it 
means that the file is being either STOREd or RESTOREd. 
The RESTORE bit (FLRESTORE) must be interrogated to 
determine which operation is taking place; see FLSR for 
a full description of the use of these bits. This flag 
is set and cleared by STORE /RESTORE, not the file 
system. 



FLSUBTYPE 



This is the device sub-type number of the first extent 
of the file. This value is determined by 
configuration . 



FLUSERID 



This is the creating user name of the file. It is 
eight bytes long with trailing blanks added. 



FLUSERLBL 



This field describes the user labels of the file. It 
consists of FLLBL and FLLBLEOF, which are described 
separately . 



FLVTAB 



This is the volume table index of the first 
the file. 



extent of 
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3.U File Multi-Access Vector Table (FMAVT) DST(%5U) 

The FMAVT is used to locate shared PACB's for files opened multi-access. Whe 
an old disc file has been opened multi-access, the FMAVT is searched to deter 
mine if the file has previously been opened. The JITDST and the DADDR found i 
the FMAVT are compared to the JITDST of the job and the DADDR of the device o 
disc file being opened multi-access. If an entry exists for the file, than th 
PACB can be easily located for that file. If this is the first process openin 
the file than an entry is created and inserted into the FMAVT for the file. 

Spoolfiles are opened multi-access, therefore, they will have entries in th 
FMAVT. $STDIN and $STDLIST also have entries in the FMAVT since they too ar 
opened multi-access. 



Zero Entry Format 



1 Current 


Table 


Size | 


i Entry 


Size = 


= it | 


! Maximum 


Table 


Size j 


1 | 



FM'CURR'SIZE 

1 FM'ENTRY'SIZE 

2 FM'MAX'SIZE 
3 

Descriptions: 

FM'CURR'SIZE The current size of the FMAVT in words. This value increases ii 
increments of %200 words until FM'MAX'SIZE is reached. 

FM'MAX'SIZE The maximum allowable size in words that the FM'CURR'SIZE can get, 
The current value of this is JlUOOO. FM'MAX'SIZE can be changec 
only by changing the code in Initial. The FOPEN fails when the 
maximum is reached. 

FM'ENTRY'SIZE Size in words of an FMAVT entry, U words at present. 
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Typical Entry Format 






12 3 6 


7 8 


12 13 


Ik 


15 


1 1 


G ! D | | 




JIT DST 




i 

i 




Logical Device 


1 










Disk 


Address 




1 PACB Vector | 



1 FM'DADDR 

2 

3 FM'PACBV 



FM 'DEVICE 
FM' GLOBAL 
FM'JITDST 
FM'LDEV 

Descriptions: 

FM'DADDR 

FM 'DEVICE 
FM'LDEV 

FM'JITDST 



FM' GLOBAL 
FM'PACBV 



FMAVT(0).(2:1)#, Device bit 

FMAVT(0).(1:1)#, Global multi-access bit 

FMAVT(0).(6:10)#, JIT DST number of job opening file 

FM'DADDR(O) . (0:8)#, Logical device number of file 



The disc address of the file label for disc files. For device 
files, the disc address is zero. 

This bit is 1 for device files and for disc files. 

Locical device number of device files or the LDEV of the disc con 
taining the file label for disc files. 

The DST number of the JIT for the job that has the file open. I: 
this field is non-zero, than only processes in the family tree o; 
this particular job can open the file. This field is zero if th« 
file was open global multi-access. 

This bit is 1 if the file was opened global multiaccess, this al- 
lows multi-access to the file between jobs. 

The PACB vector for this multi-access file. Used to easily fin< 
the Physcial Access Control Block for files opened multi-access. 
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3-5 System Global Area (SYSGLOB) 



The file system uses several words in the system global area for its own 
use. 



SHFCBDST 

MONITOR 

MAXSSECT 

NUMSSECT 

EXTSSECT 

SPOOLINDEX 

CSIOWAIT 

CCLOSEPLABL 

DSCHKPLABL 

DSOPENPLABL 

DSCLOSEPLABL 

SDSLDEVLABEL 

MANWCPLABL 



SYSDB+5I76, shared FCB DST no. 

SYSDB+5l77i monitoring flag word 

SYSDB+%100, max # spoolfile sectors 

SYSDB+J1102, current # spoolfile sectors 

SYSDB+%10U, # sectors/spoolfile extent 

SYSDB+%132, class spool index 

SYSDB+%135, CSIOWAIT PLABEL 

SYSDB+%lU0, CS CCLOSE PLABEL - FPROCTERM 

SYSDB+%335, DSCHECK PLABEL 

SYSDB+%336, DSOPEN PLABEL 

SYSDB+%337, DSCLOSE PLABEL 

SYSDB+%323, PLABEL for SDSLDEV 

SYSDB+fc^O; MANAGEWRITECONV PLABEL 



6-52 



3.6 SIRs, Locks, and Deadlocks 



The file system uses two SIRs: the File SIR, which is intended to 
protect file label integrity, and the FMAVT SIR, which is to guarantee 
the integrity of the FMAVT. Since the file system locks these 
resources, and also locks control blocks, deadlocks can occur if locking 
is done in the wrong order. Not only must the file system handle 
locking correctly, but the entire ensemble of the file system, its 
callers, and its callees must do so also. These include KSAM, which has 
a SIR of its own, and SYSDUMP and STORE, which lock the File SIR because 
they tweak bits in file labels. The presently accepted order is: 

Get FMAVT SIR 
Lock AC6 
Get File SIR 
Lock FCB 

It may not be necessary to do all of these things in any particular 
procedure. In modifying a procedure, you should be sure that any of 
these locks which you change are consistent not only within your own 
code, but also with its callers and callees. 
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CHAPTER 7 PROCESS TABLES 



7.1 Introduction 

The operating system maintains state, control, and accounting information 
on each process. The data structures for this purpose are the process coj 
trol block table (PCB; core resident, 1 entry per process) and the procesi 
control block extension (PCBX; contained in the process' stack below DL). 
Process related information which must be accessible even when the procesi 
stack is not present in main memory is maintained in the process' PCB 
entry. All other process related information is maintained in the proces: 
PCBX. 

A process is identified in the system by its PCB entry number, referred ti 
as its PIN (process identification number), or by its PCBPT=(PIN)*(PCB 
entry size). 

The structure of the PCB table, PCB entry format, PCBX structure, and PCE 
format are specified in this chapter. 

7.2 Process Control Block Table Structure and Format 

7.2.1 Fixed Cells Related to PCB 

3 Absolute address of base of PCB table 
k Absolute address of current process' PCB entry 
#1003 Sysbase relative address ov PCB table base 
5&1271 Sysbase relative address of head of dispatching queue's PCB 

entry 
%1272 Sysbase relative address of tail of dispatching queue's PCB 
entry 
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7.2.2 PCB Entry Format 



| 

0| # OF CONFIGURED ENTRIES 
I 

1| ENTRY LENGTH (#20) 

I 

2 | # OF UNASSIGNED ENTRIES 
| _ __. 

3 1 TABLE RELATIVE INDEX TO FIRST UNASSIGNED ENTRY 
I 

»»| 
I 

51 o 
I 

6| 

I 

71 

| -.,„„... 

8| 
| 

91 o 
I 

10| 

I 

Ill 

I 

12| 

I 

131 

I 

1U| o 

I 

151 

I 
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7.2.3 Unassigned PCB Entry Format 



o 


JtlOOOOO 


ll TABLE RELATIVE 


INDEX TO NEXT UNASSIGNED ENTRY 


2 





31 





U | 





51 





61 





7j 





81 





91 





10 1 





111 





12 1 





13 i 





iui 





151 
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7.2.3 Assigned PCB Entry Format 
1 2 3 h 5 6 7 8 9 10 11 12 13 l>» 15 



PCB00 



PCB01 



PCB02 

PCB03 

PCBOU 

PCB05 
PCB06 
PCB07 

PCB08 



PCB09 

PCB10 
PCB11 
PCB12 
PCB13 



PCBlU 
PCB15 



|C 
IR 
U 
IT 



IH 
IS 
II 
IR 



I I I 



IP 
U 
10 
IV 
IR 



IH 

IS 
IP 

IR 
II 



U 
IP 
IE 
IX 
IP 



I 
P |D 

C js 

10 
IF 
IT 



-l-l-l-l-l- 

S |T |U |H |S |R 

W |R js |I |T jl 

|W |E |P |0 |T 

I ID |R |V |B 

I IQ U IA |K 



SYSBASE RELATIVE ADDRESS OF 
LOCALITY LIST 


PROCESS' SEGMENT 


A | 

D | XDS DST# 
B I 






1 

| RESERVED 

1 


A| 

0| STK DST# 






1 s| 

| C| RESERVED 


1 1 1 1 B| | U| J| 

M| R| R| M| I| I| C| N| 

| G| L| A| 0| 0| P| K| 


T| 
II 
Ml 


Ml 

s| 

G| 


S| | I| S| T| M 
0|FA| M| ij I| E 
NJ | PJ RJ MJ M 


FATHER'S PIN | 






SON'S PIN 


NEXT BROTHER'S PIN | 






BLKIDX 


PIMP PIN | 






BPTLINK 



|w 

IS 

PSIM |0 

IF 

IT 



OA 



BMS 



| PPC |S 
I 10 
I IV 



D| | 

E|F | 

A|A | 

D|C | 

I I 



NIMPPIN 



PTYPE |S |HK|SK|ST|HB|CY|BK 
U I I I 

I I 



EVENT FLAGS I ' |WS 
SEGIDENTIFIER OF LAST REF. SWAPPABLE SEGMENT 



CSTX BLOCK MAP INDEX 



D |L 
I IQ 
S I 
P I 
Q I 



D |E |I |C |A 

I IN |0 |S 

I IT |R |0 

I IE |E |F 

I |R IR IT 



PRIORITY 



SYSBASE INDEX OF NEXT PCB ENTRY IN QUEUE 
SYSBASE INDEX OF PREVIOUS PCB ENTRY IN QUEUE 



RESABORTINFO 



SLLPTR 



DBXDSINFO 

STKINFO 

WAKEMASK 

FATHERSONINFO 
| BROTHERINFO 
PIMPINBREAKLINK 

PIINFONIMPPIN 



PROCSTATE 

EVENTFLAGS 
LASTREFSWAPSEG 
PBX 
QUEUEINGINFO 



NQPTR 

PQPTR 
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7.2.U PCB Assigned Entry Field Descriptions 



PCBOO 



PCB02 



PCB03 



(0:1 

(1:1 
(2:1 
(3:1 
(U:l 

(5:1 
(6:1 
(7:1 
(8:1 



(9:D 

(10:1) 

(11:1) 

(12:1) 

(13:1) 

(1U:1) 

(15:1) 



PCB01 .(0:16) 



(0:1) 
,(1:10) 

,(11:U) 

.(0:1) 
.(1:10) 
.(11:1) 
.(12:3) 



SAR ==> scheduling attention required 

Bounds Flag -- Priv mode bounds check 

CRIT ==> process is critical 

HSIR ==> process has a sir 

PIOVR ==> pending PI, process critical 

HSPRI ==> hold sir priority 

IPEXP ==> incore protect expired 

PC ==> prempt capability 

DSOFT ==> Delayed soft int processing. A pending 

soft int cannot be processed because of sir 
or critical state. PSEUDOINT will be invoked 
when these condition(s) go away, 
long wait 
short wait 
> terminal read wait 

==> used a quantum since transaction began 
==> hold impeded priority 
==> processing abort due to stack overflow. 



LW ==> 
SW ==> 

TRW == 

USEDQ 

HIPRI 

STOVA 

RITBK 



SLLPTR, SYSBASE relative index to process' segment 
locality list 

ADB, set if db pointing to an absolute address 
XDS, DST entry number of extra data seg. to which 
DB is set; zero if none. 
Reserved for expansion of DST entry number field 

STOVRALL FLAG ==> stack overflow is already allocated 
DST entry number of process' stack 
SC, set if executing system code 
Reserved 



PCB0U 



(0:1) 
(1:1) 
(2:1) 
(3:1) 
(U:l) 
(5:D 
\ w • ■»■/ 
(7:1) 
(8:1) 
(9:1) 

.(11:1) 
.(12:1) 

.(13:1) 
•(1U:1) 
.(15:1) 



M, mourning wait. 

RG, global RIN wait. 

RL, local RIN wait. 

MA, mail wait. 

BIO, blocked 1/0 wait. 

10, 1/0 wait. 

UCP, UCOP wait and RIT wait. 

JNK, junk wait. 

TIM, timer wait. 

MSG, file system basic ipc message wait. 



COM 



e nn TJfl T +. 



FA, father wait. 

IMP, process waiting to be unimpeded. 
SIR, process waiting for a sir. 
TIM, process waiting for a time out. 
MEM, process waiting for memory. 
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PCB05 
PCB06 
PCB07 
PCB08 



PCB09 



.(3:1) 
.(U:2) 



•(6:1) 
.(7:1) 

.(8:8) 

•(0:1) 
•(1:2) 



(3:2) 



(5:1) 
(6:3) 



•(9:1) 

.(10:1) 
.(11:1) 



.(0:8) FPIN, father's PCB entry number 
.(8:8) SPIN, son's PCB entry number 

.(0:8) BPIN, brother's PCB entry number 
.(8:8) BLKIDX (reserved) 

.(0:8) PIMPPIN, previous impeded pin. 
.(8:8) BPTLINK, breakpoint link for process. 

•(0:3) PSIM, pseudo - interrupt mode 
1: hard kill 
2: soft kill 
3: stop 
U: hibernate 
5: escape 
6 : break 
7 : normal 
ASOFT, OK for soft int to wake process 
even though it is waiting on another event. 
OA 
0: other source 
1 : father 
2: son 

3: reply done on RIT wait 
DEAD, set during expiration. 

FAC, if set, the father is to be activated on process 
termination. 
NIMPPIN, next impeded process' pin 

LIVE, set if process is alive. 
BMS, block mail, valid if HA set 

0: sent to father 

1: rec from father 

2: send to son 

3: rec from son 
PPC, process to process communication, set with 
respect to son. 

0: null 

1: son to father 

2: father to son 

3: blocked 
STOV, stack overflow bit 



PTYPE, process type 



user 

user, son of main 

user, main 

user, main, task 

system 

system, UC0P 



SI, set when the Dispatcher (and PSEUDOINT) 
should be aware of a pending soft interrupt. 
HK, hard kill pseudo interrupt 
SK, soft kill pseudo interrupt 
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.(12:1) ST, stop pseudo interrupt 

Ttl3:l) HB, hibernate pseudo interrupt 

. (lU:l) CY, control-y pseudo interrupt 

.(15:1) BE, break pseudo interrupt 

PCB10 .(0:15) EVENTFLAGS, one for each wait class in PCBOU 
.(15:1) WS, wake up waiting switch set if an awake is 
missing. 

PCB11 .(0:16) LASTREFSWAPSEG, segment identifier of last 
referenced swappable code segment. 

PCB12 .(0:l6) PBX, CSTX block map index of process' program. 

PCB13 (QUEUEING INFO) 

.(0:1) DISPQ ==> on dispatching queue 

.(1:1) L scheduling class 

.(2:1) C scheduling class 

.(3:1) D scheduling class 

. (U:l) E scheduling class 

.(5:1) INTER ==> process is interactive 

.(6:1) CORER ==> process is core resident 

.(7:1) ASOFT, Allow soft interrupt. A value of 1 
implies that user soft interrupts will be 
processed. A zero value inhibits user soft 
ints (they are queued) . This bit is managed 
by FINTSTATE and FINTEXIT intrinsics. 

.(8:8) Process' scheduling priority 

PCBlU .(0:l6) NQPTR, sysbase index of PCB entry of next process in schedul- 
ing queue 

PCB15 .(0:l6) PQPTR, sysbase index of PCB entry of previos process in 
scheduling queue 
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7-3 PCBX Structure and Format 

7-3.1 PCBX General Structure 



a > 



b- — > 



DL-a = SEG. REL DL VALUE 
DB-a = SEG> REL DB VALUE 



c-b = PXFIXED LENGTH 



PXFIXED EXPANSION AREA 
BIT MAP 
(h words) 



PXFIXED EXPANSION 



c > 



d---> 



DL— > 



DB— > 



d-c = PXFILE LENGTH 



PXFILE EXPANSION/CONTRACTION 
I 
I 



COUNT OF SECTORS ALLOCATED 
FOR PXFIXED EXPANSION 



DL-c 
DL-b 
DL-a 



I 

I 

I 

PXGLOB 

I 

I 



PXFIXED 



I 

PXFILE 

I 



PCBX 
SIZE 



\ / 
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7-3-2 PXGLOB FORMAT 

The PXGLOB portion of the pcbx is for job information, and contains the 
same job related information for all processes belonging to the same jo' 



1 2 3 U 5 6 7 8 9 10 11 12 13 l 1 * 15 



DL-a=SEG. REL DL VALUE 
DB-a=SEG. REL DB VALUE 



USER ATTRIBUTES 
JMAT INDEX | ACTUAL JOB INPUT LDN 



JPCNTINDEX(RelByteAddr)| ACTUAL JOB OUTPUT LDN 
STACK DUMP FLAGSI JDT DST INDEX 



//| R| TT | D| I| 

JCUT INDEX 



JIT DST INDEX 

I **!//!***** I /////////// 



R = restart bit 
I = job in/list interactive 
D = job in/list duplicative 
TY = job type 

= undefined 

1 = session 

2 = job 

3 = task 

* = reserved: 



1 



Stack Dump Flags 

Bit = Armed 

Bit 1 = Suppress traceback 

Bit 2 = Suppress ASCII 

Bit 3 - Q-63 to S 

Bit k = QINIT to S 

Bit 5 = DL to QINIT 
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7-3.3 PXFIXED ASSIGNMENTS 

The PXFIXED portion of the pcbx contains specific information and control 
information. 



10 



11 



12 



13 
Ik 

15 
16 



17 



20 



21 



22 



23 
2k 

25 
26 



27 



c-b PXFIXED SIZE 



RELATIVE S(S-DB) 



RELATIVE Z(Z-DB) 



INITIAL Q(Q-DB) 



INITIAL RELATIVE DL (DB-DL) 



GENERAL RESOURCE CAPABILITY (FROM PROG-FILE) 



RESERVED 



|MAT|MLT|MST|MCY 



LINK TO XDS ENTRIES IN EXPANSION AREA| XDS CNT 



PI S| 



EXTRA DATA SEGMENT DST INDEX 



P| S| EXTRA DATA SEGMENT DST INDEX 



P| S| EXTRA DATA SEGMENT DST INDEX 



P| S| EXTRA DATA SEGMENT DST INDEX 



X| A| ABORT Y 



|RW| INITIAL CST INDEX 



MAXIMUM STACK SIZE(MAXDATA LIMIT) 



ARITHMETIC TRAP MASK 



ARITHMETIC TRAP PLABEL 



LIBRARY TRAP PLABEL 



SYSTEM TRAP PLABEL 



CONTROL Y PLABEL 



JOB | 
TYPE J 



J0B# 



ACTUAL SIZE OF VIRTUAL SPACE ALLOCATED TO STACK 



USER ABORT PLABEL 



U |L | C 1 1 II 1 1 llll II | A | LOAD PROCEDURE I.D. 



CUR. MAX STACK SIZE (largest value ever for Z-DL) 



Trap Modes 

5 .MAT(12:1)-Arith. 
.MLT(13:1) -Library 

6 .MST(lU:l) -System 
.MCY(15:1)-Ctl-Y 

7 (XDS CNT- 12 :k) 



8 



10 / 0:1 RESERVED FOR 

| CST EXPANSION 

11 j 1:1 - 1 IF ABORT 

I IN PROGRESS 

12 < 7:1 = IF HAVE R/W 
| ACCESS TO 

13 I PROG FILE 

j = 1 OTHERWISE 
Ik j 8:8 = CST # OF SEG 

I INITIALLYEXECUTED 
AT PROC CREATION 



15 \ 
16 



17 

18 

JOB TYPE: 
l=SESSION 
19 2=J0B 

20 

21 

U user udcs exist 

22 L logging 

A acct udcs exist 

23 C process shares clock 

1 => clock shared 
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(reserved) 



PXFIXED (CONT.) 









30| 
31! 




PROCESS CPU TIME 

(MSEC) ! 


2U 
25 


32! 


MAXIMUM DATA SEG SIZE USED (IN SECTORS) | 


26 


331 


TOTAL VIRTUAL STORAGE USED (IN SECTORS) 


27 


3U| 


CURRENT EXTRA DATA SEGMENT SPACE 


28 


351 


MAXIMUM EXTRA DATA SEGMENT SPACE 


29 


36| 


PRIV MODE BOUNDS FLAGS | STOV COUNT 


30 


371 


PROCESS EXECUTION TIME REMAINDER (IN MSEC) 


31 


1*0 


SET TO-1 WHEN IN BREAK MODE* 


32 


1*1 


CONTINUE FLAG (: CONTINUE COMMAND)** 


33 


1*2 


IMAGE PLABL 


3U 


1*3 


ERROR LEVEL 


35 


1*1+ 


INTRINSIC ERRORS 


36 


U5 


INTRINSIC ERRORS 


37 


1*6 


INTRINSIC ERRORS 


38 


1*7 


INTRINSIC ERRORS 


39 


50 


INTRINSIC ERRORS 


1*0 


51 


INTRINSIC ERRORS 


1*1 




TSLR 


tiirH-nal +iino einpa last TOSfhftrful <><3 


1*2 


53 


TSTB, 


virtual time since transaction began 


1*3 


>-* 


TggufiDTii virtual tims since swa^in 


\hh 


55 


TSLA, 


virtual time since last absence 


|1*5 


56 


TSLD, 


virtual time since last deallocation 


|U6 


57 


QCNT, 


quantums used since transaction began 


|1*7 


60 


|/|D|/|0| RESERVED FOR FUTURE SOFT INT USE 
l/|C|/|S| 


1 1+8 

i 
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i/m/m 

i 

6l | TRLX INDEX FOR KERNEL TIMEOUT PROCEDURE 



I 



62| 

I 

631 



6l+| 

I 
651 



66| 
I- 

671 

I- 
70| 

I- 
7H 

I- 
72| 

I- 
731 

I- 
7U| 

I- 
751 

I- 
76| 

I- 
771 

I- 
100 1 

I 

101 1 

I- 

102 1 

I 

1031 



CY 



DATACOMM TERMINATION TRAP PLABEL 

# SL FAULTS 

# PCB FAULTS 

# DATA SEG FAULTS 

# BLOCKED DISC I/O's ISSUED 

# UNBLOCKED DISC I/O's REQUESTED 

# UNBLOCKED DISC I/O's WAITED ON 

# IMPEDES (SUBSYSTEM) 

# IMPEDES (SYSTEM) 

# SIR BLOCKS 
|SI| 

TIMEOUT TRLX 

RESERVED 
RESERVED FOR DEBUG 
PCLASSMASK 
PROCQUESTOPWORD 



PROCSTOPTIME 



NOTES: P = 1 if opened by priv user 
S = 1 if data seg is sharable 



kg 

50 

51 

52 

53 

5U 

55 

56 

57 

58 

58 

60 

61 

62 

63 

6k 

65 

66 

61 



PCLASSMASK = BIT MASK OF CLASSES THIS PROCESS HAS ENABLED 
PROCQUESTOPWORD. (0:U) = PROCESS PRIORITY: 7 => L QUEUE 

6 => C QUEUE 
2 => D QUEUE 
1 => E QUEUE 
.(U:12)= REASON STOPPED: 1 => STOP SEG FAULT 

2 => STOP DISC WAIT 

3 => BLOCKED I/O, NON TERMINAL 
k => TERMINAL READ 

5 ■> STOP IMPEDE 

6 => STOP ACTIVE 
PROCSTOPTIME = DBL WORD TIMESTAMP OF WHEN PROCESS STOPPED FOR 
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REASON GIVEN IN PROCQUESTOPWORD 

DCY A DELAYED CONTROL Y IS PENDING (THIS BIT 

IS CHECKED BY ININ ON BOUNDS VIOLATION TO 
DETERMINE IF GOT: 1) TRUE BOUNDS VIOLATION 
OR 2) AN INDUCED BOUNDS VIO THAT INDICATES 
THAT THE CONTROL Y TRAP PROCEDURE MAY NOW 
BE ENTERED). 
OSI STATE OF THE "ASOFT" PCB BIT WHEN CONTROL Y 

TRAP WAS ENTERED. ASOFT » 1 ALLOWS USER SOFT 
INTERRUPTS AGAINST THE PROCESS. IT IS SET TO 
ZERO WHEN THE CONTROL Y HANDLER IS ENTERED. 
IT IS SET TO ITS PRIOR STATE WHEN THE USER 
CALLS RESETCONTROL. 
* SET TO COMMAND RECORD LENGTH WHEN COMMAND PENDING 
(I.E. COMMAND ENTERED DURING BREAK OR ENCOUNTERED 
DURING FLUSHING) . 

** CONTINUE FLAG VALUES 

= NO CONTINUE IN EFFECT 

1 = CONTINUE JUST ENCOUNTERED 

2 = CONTINUE IN EFFECT FOR THIS COMMAND 



CY FLAG 

PCBXFIXED(6l).(l:l) 



= SET BY PSEUDOINT WHEN THERE IS A PENDING 
CONTROL Y WHICH CANNOT BE PROCESSED BECAUSE 
OF SYSTEM CODE OR PRIVILEGED CODE. ININ 
CHECKS THIS BIT ON BOUNDS VIOLATION OR 
TRACE TRAP. 



SI FLAG 

PCBXFIXED(6l).(3:l) 



= SPECIFIES THE STATE OF THE USER INTERRUPT 
FLAG WHEN THE CURRENT CONTROL Y WAS PROCESSEI 
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7-3.U PXFIXED EXPANSION BITMAP 

The PXFIXED bitmap and expansion area is for use in accounting for 
extra data segments acquired by the process. 

The names of extra data segments allocated by and belonging to a 
process are kept in the PXFIXED part of the PCBX. Up to four such 
names (DST numbers) can be kept in cells that are permanently 
allocated for this purpose at PXFIXED locations 8 through 11. If 
more than four extra data segments are allocated, an expansion of 
PXFIXED occurs in which it is enlarged by one sector (128 words). 
Up to three such sectors can be allocated. 

The expansion area is managed by a cumbersome scheme in which each 
sector is divided up into "frames" of eight words. The first word 
of each frame contains the frame size in the low k bits, and a 
pointer to the next frame (or zero, if none) in the upper 12 bits. 
The frames are allocated by a bitmap; one bitmap word is needed for 
each expansion sector, and the words are stored at locations 76,77, 
and 78 in PXFIXED. Although a procedure exists to de -allocate a 
frame, it is never called. The original intent presumably was to 
permit use of frame space by activities other than DST management, 
but nothing of this sort has been done. 

In order to permit the four PXFIXED words to be managed as a frame, 
they are preceded by a word at PXFIXED(7) which is in the frame 
header format described above; initially, the frame size field is 
k and the pointer is 0. 

Pictorially, a frame looks like this: 

1 2 3 U 5 6 7 8 9 10 11 12 13 Ik 15 

I LINK TO NEXT FRAME | AVBL WORDS | 

I P I S | DST NUMBER OF XDS | 

I P I S | DST NUMBER OF XDS | 

. . . (total U [first frame] or 7 [all add'l] DST words) 

P=0 if DST is privileged; i.e., creator was in privileged mode. 

Non-privileged DSTs are subject to a SYSGLOB limit on the number 
of such DSTs per process. Also, non -privileged users of the extra 
data segment intrinsics see only a "logical" index which is 
basically the negative ordinal position of the PXFIXED slot containing 
the DST number, but with the sign bit cleared. Privileged callers 
get the actual DST number to use, so they can do privileged 
instructions such as MFDS. 

S=0 if DST is specified as sharable between processes within the job. 
There is a list of shared DSTs in the JDT. 
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File System Section of PCBX (PXFILE) 

The PXFILE area is a sub-section of the PCBX. It is a contiguous, expandable 
and contractable block of storage that is managed by the file system primarily 
for its own use. Other sybsystems, namely CS and DS, also make use of the 
PXFILE section. In doing so they must conform to the conventions of the file 
system . 

The overall structure of the PXFILE area is: 



OVERHEAD 



CONTROL BLOCK 
TABLE 



AVAILABLE 



AVAILABLE FILE 
TABLE 



(fixed) 



(variable) 



(variable) 



(variable) 



VECTOR FORMAT 

56 
! 

I ENTRY I 



15 



DST NUMBER 
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Overhead (PXFILE) 



The part labeled OVERHEAD contains information that is 
pertinent to the entire table. 



1 




7 


8 




15 


I PXFILE SIZE IN WORDS | 


| LAST DOPEN ERROR NUMBER | 


LAST COPEN ERROR NUMBER j 


1 N | ( 


| LAST DF AFT 




1 




SLAVE 


AFT NUMBER j 


| LAST KOPEN ERROR NUMBER | 


LAST FOPEN ERROR NUMBER | 




AFT SIZE : 


[N WORDS 






CS 


TRACE FILE INFO 




I LAST RESPONDING 


NO-WAIT 


I/O AFT ENTRY NUMBER { 


| 1st USER 


(NOBUF) 


CONTROL 


BLOCK 


TABLE 


DST NUMBER | 


j 2nd USER 


(NOBUF) 


CONTROL 


BLOCK 


TABLE 


DST NUMBER j 


I 3rd USER 


(NOBUF) 


CONTROL 


BLOCK 


TABLE 


DST NUMBER | 


| *tth USER 


(NOBUF) 


CONTROL 


BLOCK 


TABLE 


DST NUMBER I 


| 5th USER 


(NOBUF) 


CONTROL 


BLOCK 


TABLE 


DST NUMBER | 


I 6th USER 


(NOBUF) 


CONTROL 


BLOCK 


TABLE 


DST NUMBER | 


1 7th USER 


(NOBUF) 


CONTROL 


BLOCK 


TABLE 


DST NUMBER | 


I 8th USER 


(NOBUF) 


CONTROL 


BLOCK 


TABLE 


DST NUMBER | 





1 

2 
3 
U 

5 
6 

7 
8 

9 
10 
11 
12 
13 
1U 

15 



In general the 

to this part of 

DEFINE 

PXFSIZE 

PXDSOPENERR 

PXCOPENER 

PXFNOCB 

PXLASTDSAFT 

PXSLAVEAFT 

PXFKOPEN 

PXFFOPEN 

PXFAFTSIZE 

PXFCTRINFO 

OVERHEAD (CONT. 



following identifiers are used when referring 
the PXFILE area: 



PXFILE! , 

PXFILE(1).(0:8)# 

PXFILE(1).(8:8)# 

PXFILE(2).(0:1)# 

PXFILE(3).(0:8)# 

PXFILE(3)-(8:8)# 

PXFILE(U).(0:8)# 

PXFILE ( It). (8: 8 )# 

PXFILE(5)#, 

PXFILE (6)#, 



«PXFILE SIZE» 
,<<LAST DOPEN ERROR CODE» 
,«LAST COPEN ERROR CODE» 
,«NO CB'S IN PXFILE CBT?>> 
,«DSNUM OF LAST DS OPEN» 
,«DSNUM OF SLAVE PTOP DSOPEN» 
,<<LAST KOPEN ERROR CODE» 
,<<LAST FOPEN ERROR C0DE» 
<<AFT SIZE IN W0RDS>> 
<<CS TRACE FILE INF0>> 
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PXFLEFTOFF = PXFILE(7)#, <<LAST RESPONDING AFT NR.» 

PXFCBT1 = FXFILE(8)#, «1ST USER CBT DST NR.» 

PXFCBT2 = PXFILE(9)# S «2ND USER CBT DST NR,» 

PXFCBT3 = PXFILE(10)#, «3RD USER CBT DST NR.» 

PXFCBTU = PXFILE(11)#, «^TH USER CBT DST NR.>> 

PXFCBT5 = PXFILE(12)#, «5TH USER CBT DST NR.» 

PXFCBT6 = PXFILE(13)#» «6TH USER CBT DST NR.» 

PXFCBT7 = PXFILE(lU)#, «7TH USER CBT DST NR.>> 

PXFCBT8 = PXFILE(15)#; «8TH USER CBT DST NR.» 



The following is an alphabetized list of the above identifiers 
along with a discussion of their meaning. 

PXFAFTSIZE 

This is the size (in words) of the Available File Table. Note 
that the size is in words and not in terms of number of 
entries. The reason for this is that it simplifies the 
calculation for the size of the available block. 

PXFCBT1-8 

These are the DST numbers of the user (NOBUF) control block 
tables. A DST number of indicates that no data segment is 
allocated. Note that a DST number is representable with ten 
bits; a full word is used to simplify the code. 

PXFCOPEN 

This contains the last COPEN error number. It is not used by 

the file system; it is included here for completeness only. 

PXFCTRINFO 

This contains information pertinent to the CS trace file. It 
is not used by the file system; it is included here for 
completeness only. 

PXFDOPEN 

This contains the last DOPEN error number. It is not used by 

the file system; it is included here for completeness only. 

PXFDSINFO 

This cell is reserved for DS. It is not used by the file 

system; it is included here for completeness only. 

PXFFOPEN 

This contains the last FOFEN error number. If it is zero then 
the last FOPEN completed successfully; if it is non-zero then 
the last FOPEN completed unsuccessfully and the number 
represents the file system error number. Note that only eight 
bits are needed to hold the error number; a full word is used 
to simplify the code. 
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OVERHEAD (CONT. ) 



PXFKOPEN 

This contains the last "KOPEN" error number. Since KSAM is 
imbedded in the file system, an FOPEN failure on a KSAM file 
can be caused by a failure to open either the key file or 
the data file. This error number is used in conjunction with 
PXFFOPEN to determine which file caused the KSAM open failure. 
Note that this error number is not used by the file system; 
it is included here for completeness only. 

PXFLEFTOFF 

This is the AFT entry number of the last file/line that 

completed a no-wait I/O; if zero then no no-wait I/O has 

been completed. This cell is maintained solely by and for the 

IOWAIT intrinsic. 

PXFNOCB 

This bit is used to signify that no control blocks are to be created in the 
PXFILE control block table. This bit is set by the NOCB parameter to the CREATE 
intrinsic or the :RUN command. The reason for this feature is to permit the 
3000/20 user to have as much stack space as possible; otherwise the MPE/30 file 
system will take away several hundred words of stack for the PXFILE control 
block table. 

PXFSIZE 

This is the size (in words) of the complete PXFILE area. It 
is the sum of the overhead block, the control block table, the 
available file table and the available block. 
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Control Block Table (PXFILE) 



The part labeled CONTROL BLOCK TABLE contains a file control 
block table. This is a new feature with MPE/30; it is not 
present under MPE/20. 

The format of the control block table is the same as any other file control 
block table. The only difference is that addressing is slightly more compli- 
cated since the table does not begin at DB+0. As a result all pointers within 
the table are table relative; the starting address of the table must be added to 
a pointer to generate a final DB-relative address. This addressing convention 
is consistently applied to all file control block tables. When the control 
block table is expanded, space is taken from 

the AVAILABLE area. If no space is available then the PXFILE 
area is expanded and the acquired space is added to the 
AVAILABLE area. 

The interested reader is referred to section 3-2 for a more 
detailed description of file control block tables. 

15 



TABLE SIZE IN WORDS 



16 

17 
18 

19 
20 
21 



DST NUMBER CONTAINING TABLE 
VECTOR TABLE SIZE IN WORDS 



LOCK WORD 
IMPEDED QUEUE 



VECTOR TABLE 



CONTROL BLOCK AREA 



In general the following identifiers are used when referring 

to this part of the PXFILE area: 

DEFINE 

PXFCBTAB = PXFILE (l6)#, 

PXFCBTSIZE = PXFILE (l6)#, 

r*AvrmpriT pt cv^tr oiactt? fnr\\m* \ 

vvAnwu Dxjvva inDuu \wlu./ 



«C0NTR0L BLOCK TABLE » 
«TABLE SIZE IN WORDS » 
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PXFDSTX = PXFILE(17)#, «TABLE DST NUMBER>> 

PXFVTSIZE = PXFILE (18)#, «VECTOR TABLE SIZE IN WORDS» 

PXFLOCK = PXFILE (19)#, «TABLE LOCK WORD>> 

PXFQUEUE = PXFILE (20)#, «TABLE IMPEDED QUEUE » 

PXFVT = PXFILE(21)#; «VECTOR TABLE>> 



The following is an alphabetized list of the above identifiers 
along with a discussion of their meaning. 

PXFCBTAB 

This is the first word of the control block table. In general 
this is used only when referring to the entire control block 
table . 

PXFCBTSIZE 

This is the size in words of the control block table. In 
general this is used only when calculating the size of the 
available block. 

PXFDSTX 

This is the DST number of the data segment that contains the 
control block table. This is the same as the DST number of 
the stack. Note that the convention of referring to the DST 
number of the stack as zero is not used. The reason for this 
is that the file system may refer to a PXFILE control block 
table in another stack. This would result in an ambiguity 
since that PXFILE control block table would also have a DST 
number of zero. 

PXFLOCK 

This is the lock word for the table and has the same format as 

the lock word for a control block in the table. 

PXFQUEUE 

This is the impeded queue for the table and has the same format 

as the impeded queue for a control block in the table. 

PXFVT 

This is the first word of the vector table. It is used when 

referring to the vector table in general. 

PXFVTSIZE 

This is the size, in words, of the vector table. Note that 
this is the length of the table and does not reflect the number 
of entries used or unused. 
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Available Block Area (PXFILE) 



The part labeled AVAILABLE BLOCK is used to provide space when 
the Control Block Table or the Available File Table is 
expanded. These two tables grow towards each other, and when 
more space is needed it is simply taken from the Available 
Block. 

When the Available Block is exhausted, the PXFILE area is 
expanded, the AFT is relocated and the new space is added to 
the Available Block. 

Note that currently the PXFILE area is only expanded; it is 
never contracted. 



Available File Table, AFT (PXFILE) 



The part labeled AVAILABLE FILE TABLE contains information 
used by the file system (or CS, DS, etc.) to grossly 
characterize the file access and, most importantly, to give 
the location of the control blocks. 

The overall structure of the AFT is: 



ENTRY N 



(fixed) 



ENTRY 1 



(fixed) 



where N = PXFAFTSIZE/U. 






are all zero's. When the table is full it is expanded by 
taking space from the AVAILABLE block. 



The AFT is negatively indexed by file number: the entry at 
DL-8 corresponds to file number 1, the entry at DL-12 
corresponds to file number 2, etc. 
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AFT (CONT.) 

The structure of an AFT entry is: 

1 2 3 U 5 6 7 8 9 10 11 12 13 Hi 15 



| ENTRY TYPE 


1 N | | 

1 1 i 


1 PHYSICAL ACB VECTOR 1 


I LOGICAL ACB VECTOR | 


I NO-WAIT I/O IOQX | 



1 

2 
3 



Note that the entry format is dependent on the entry type. The 
one shown above is the one used by the file system. 

In general the following identifiers are used when referring to 
an AFT entry: 



DEFINE 

AFTTYPE = AFT.(0:U)#, «ENTRY TYPE» 

AFTNULL =AFT.(U:1)#, <<$NULL FILE» 

AFTPACBV = AFT(1)#, «PACB VECT0R» 

AFTLACBV = AFT(2)#, «LACB VECT0R» 

AFTIOQX = AFT(3)#; <<N0-WAIT I/O I0QX» 
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AFT (CONT.) 

The following is an alphabetized list of the above identifiers 
along with a discussion of their meaning. 

AFTIOQX 

This is the IOQ index of the pending no-wait I/O (if any). 
Note that this is applicable iff the file was opened with the 
NOWAIT option specified. Also, CS and DS have the same 
capability and use this cell in a consistent manner. The 
reason for this is that the IOWAIT intrinsic services the file 
system as well as CS and DS, and is the principal user of this 
cell. If the cell is zero then there is no I/O pending; 
otherwise the cell contains the IOQ index corresponding to the 
pending I/O. 

Exception: a nonzero value for message files specifies the accesors 
reply port (instead of an IOQ entry). 

AFTLACBV 

This is the vector of the Logical ACB (LACB) (if any). Note 
that this is applicable iff the file was opened with the 
multi-access option specified. 

AFTNULL 

This bit signifies that the file is $NULL and that there are no 

control blocks. 

AFTPACBV 

This is the vector of the Physical ACB (PACB) . Note that a PACB 

exists for all files except $NULL. 

AFTTYPE 

This is the AFT entry type number. At present the following 

entry types are defined: 

- file system 

1 - remote file 

2 - DS (no-wait I/O disallowed) 

3 - DS (no-wait I/O allowed) 
U - CS 

C _ f*C ( ATFTm FtTAT \ 

6 - KSAM 

8 - message file 
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PCBX FOR CORE RESIDENT SYSTEM PROCESS STACKS 



0| DL-a (Seq Rel DL Value) |0 | 

j b I i 


1 _ 1 j 

1| DB-a (Seq Rel DB Value) |1 | 

j 1 i 


l_ 1 | 
2| USER ATTRIBUTES (always -1) |2 | 


1 . 1 j 

31 | INPUT DEV LDEV |3 I 


h\ | OUTPUT DEV LDEV |U | 

j j 


51 15 1 

I , i i 


61 | D| l| o \6 \ 

j j 


71 17 1 

10 | PXFIXED SIZE (c-b) |8 | 
j i i 


i _ l | 

111 RELATIVE S (S-DB) |9 | 
i i 


1 1 | 

12 | RELATIVE Z (Z-DB) |10 | 

i i 


1 1 j 

131 INITIAL Q (Q-DB) |11 | 
j j i 


1 1 | 

1U| RELATIVE DL (DB-DL) |12 PXFIXED 
I i 


1 _ __ 1 | 

151 GENERAL RESOURCE CAPABILITY (-1) |13 I 
j I I 


1 1 j 
16 | RESERVED |lU | 




171 |15 ! 

i i 


l 1 j 

20 | DL-c |16 | 
1 | 


1 1 j 

21 | DL-b |17 I 


22 | DL-a |18 



NOTES: 1. there is no PXFILE area. 

2. the PXFIXED area is much smaller than a normal PCBX. 
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PROCESS TO PROCESS COMMUNICATION TABLE 



This table is used as the communication link by which father and son 
processes communicate with one another via the mailbox scheme. This 
table contains two words per entry and is indexed by PCB# (entry index 
is meaningless). Each two word entry of index N essentially relates 
where, as well as how much, mail may be found for a process N with respect 
to communications between N and his father process. 



ENTRY FORMAT 







word 


WORD COUNT 


word 1 


MAIL WORD OR DST# 



where word 



word 1 



the # of mail words to 
be transferred, 
the only word of mail 
itself if word 0=1 

otherwise 
it contains the DST# of 
the extra data segment 
where "word count" words 
of mail exist. 



NOTE: Assume process S is the son of process F. Then the process to 

process communication table index which will be used for mailbox commun 



eaxion. Between son s ana ratner r win Be inai oi "cne son vi« e » S; 



_» _»_*_ 
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SUB -SYSTEM RESERVED DL AREA 



REMAINING DL AREA 



DB-12| 
DB-llI 
DB-lOl 
DB-71 
DB-6| 
DB-5i 
DB-U| 
DB-31 
DB-2| 
DB-ll 



RESERVED FOR SORT/MERGE 



RESERVED FOR TRACE & TOOLBOX 
EXTERNAL PLABEL OF OUTER BLOCK 
RESERVED FOR TRACE & SYMBOLIC DEBUG 
DB ADDRESS OF STLT 



RESERVED FOR COBOL 
RESERVED FOR COBOL 



RESERVED FOR COBOL 

RESERVED FOR FORMATTER & PASCAL 

DB ADDRESS OF FLUT 



IDB-10 

|DB-9 

|DB-8 

|DB-7 

|DB-6 

|DB-5 

|DB-U 

IDB-3 

|DB-2 

lDB-1 



DB AREA 
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FORTRAN LOGICAL UNIT TABLE (FLUT) 



The segmenter is responsible for the preparation and initialization 
of a Fortran logical unit table. This is done when a program is 
prepared if that program contains at least one program unit that 
references a logical unit. The location of the FLUT is in the 
secondary DB area and the address of this location is contained in DB-1. 

The FLUT is formatted as per the following example: 



DB-1 



DB+X 



i x i 


1 3 


i 


1 u 


o 1 


1 5 


o 1 


! 7 


o ! 


|10 


o 1 


1255 


///I 



I 

1st BYTE 
List of the logical unit numbers 
referred to in this Fortran- 
produced program. 
(255 terminates) . 

0123U5678 



I--I-I-I 



I 

2nd BYTE 
The MPE file number (as returned 
by FOPEN) used in accessing the 
file. Zero if file not open. 
Filled in by formatter as each 
l.u. is initially referenced. 
9 10 11 12 13 lU 15 
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CHAPTER 8 JOB TABLES 



JMAT - JOB MASTER TABLE STRUCTURE 



SIR = 15(10) = 5417 
DST = 25(10) = %31 





1 
2 
3 
U 

5 
6 

7 
10 
11 
12 
13 
11+ 



1 K 



16 

31 
32 



0123U5678 9101112131U15 
MAXSIZE I CURSIZE 



ZEROTH 
ENTRY 
I 
I 
I 
I 



VMOUNT INFO |; ENTRY SIZE 
ENTRY POINTER 



TY| 



SCHEDULING HEAD POINTER 
SCHEDULING TAIL POINTER 
SCOUNTER 



TYJ JCOUNTER 
LG| SEC I //////////////// JOBFENCE 



SLIMIT 

SNUH 



JLIMIT 
JNUM 



WORKAREA 
(lUWDS) 




1 
2 
3 
U 

5 
6 

7 
8 

9 

10 

11 

12 

1 •* 
-■-•■/ 

lU 

25 
26 



max JMAT size (words /128) 

current JMAT size ( words /l 28) 

: VMOUNT state saved for WARMSTARTs 

JMAT entry size (26) 

DB pointer to first entry (26) 

DB pointer to word of head 
entry in scheduling queue 
DB pointer to word of tail 
entry in scheduling queue 
next assignable session #, TY=1 

next assignable batch #, TY=2 

LG=1, logoff in progress 
SEC=0,high;=3,low JOBSECURITY 
maximum number sessions C E 

\ U X 
current number sessions | R E 

| R C 
maximum # batch jobs 



current # batch jobs 



> E U 

| N T 

| T I 

/ L N 

Y G 
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JMAT (CONT.) 



ENTRY 1 



631 



151 



I 

V 



I LAST 
I ENTRY 



SCHEDULING QUEUE 

WAITING SESSIONS 

FIFO WITHIN HIPRI /INPUT PRIORITY 
[ERROR JOBS ] 
[ FIFO ] 
WAITING JOBS 

FIFO WITHIN HIPRI/INPUT PRIORITY 
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JMAT - Job Master Table Entry 

111111 
0|l:2:3l 1 *:5:6|7:8:9|0:l:2|3: 1 *:5 





1 

2 
3 
k 
5 

6 

7 
10 
11 

12 
13 
lU 

15 

16 
17 
20 
21 

22 

23 

21* 

25 

26 
27 
30 
31 



state :D|I:G:A|U:C: INPRI 
ty: job/session number 



user name 



account name 



aM 



job name 



^ 



group logon name 



JIN device : JLIST .device 
Julian date (CALENDAR) 
time (CLOCK) 



main pin : XPRI 
CPU lim. (0 deflt, -1 no lim.) 



S|R:N:FT :0UTPRI : NUMCOPIES 
ORIGJIN : ORIGJLIST 



2 
3 

U 

5 

6 

7 
8 

9 

10 
11 
12 

13 

lU 

15 

16 

17 
18 

19 



| 1: 2 :3|U: 5:6 | 7: 8:9 | 0:1: 213:^:5 

111111 



R = RESTART 

N = SEQUENCED 

S = ORIGJIN is spooled. 



state 

= free entry 

1 = introduced, in 

STARTDEVICE 
%k0 = waiting, job in 

scheduling queue 
?o60 = initial, UCOP 

has created JSMP 

2 = executing, JSMP 

finished initial. 

3 = terminating. 
k = suspended. 

D = duplicative 

I = interactive 

(G = group password 

{(QUIET mode, if state=2) 

{A = account password 

(STDLIST DELETE, if state=2 or 3) 
{U = user password 

{0 = password validated (STARTDEVICE) 
{1 = must validate 
{ password 



(INITJSMP) 



C = JLIST is device 
class index 





ty 


= l - 


- session 


20 




2 ■ 


- job 


21 









22 



23 



2k ORIGJIN/ORIGJLIST is 

h&ra^VA CA«S «* OVil^Wil * ■ • • r, 

25 link by UCOP (state= 
%k0) . DB rel. ptr. to 
next entry. Last entry 

FT = funny terminal 

00 - regular term. 

01 - regular term. , 

special logon 

10 - APL term. 

11 - APL term. 
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JOB STATES 



JOB STATES - JMAT ENTRY WORD 0.(0:6) 

SHOWJOB - Displays job states by scanning JMAT DST (Jt31) 

LOGON USES ALL STATES EXCEPT "SUSPEND" 



| STATE 
j NO. 


STATE 
NAME 


PROCESS 


SEGMENT 


PROCEDURE (S) | 


I 1 


INTRO 


DEVREC 

JSMP 

SPOOLER 


NURSERY 


STARTDEVICE ->PUTJMAT | 
->ALLOCENTRY IN SEGMENT j 
ALLOCUTIL | 


1 %Ho 


WAIT 


DEVREC 
JSMP 

SPOOLER 


NURSERY 

\ 
SPOOLING 

/ 


STARTDEVICE - >SCHEDULE JOB | 
SPOOLSTUFFIN - >SCHEDULE JOB | 


I %6o 


INIT- 
IALIZAT- 
ION 


UCOP 


UCOP 


LAUNCHJOB | 


1 2 


EXEC 


JSMP 


NURSERY 


INITJSMP I 


1 3 


TERMIN- 
ATING 


JSMP 


MORQUE 


TERMINATE ->EXPIRE -> | 
CLEANUPJOB | 


1 o 


FREE 
ENTRY 


JSMP 


MORQUE 


TERMINATE ->EXPIRE -> | 
CLEANUPJOB ->DEALLOCENTRY | 
IN ALLOCUTIL | 



| k I SUSP I JSMP 



OPLOW 



CXBREAKJOB 



For states INTRO and WAIT, 

DEVREC => logon command originated on terminal or 
other unspooled device. 

SPOOLER => logon command originated on spooled device. 

JSMP => logon command is the result of the execution of 
a : STREAM command.' (This also includes USER 
processes which have done programmatic : STREAMS.) 
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JPCNT - JOB PROCESS COUNT TABLE 



(1 Entry/Running Job) 



CORE RESIDENT 

SYSGLOB BASE = DB+13(Jil5) 
DST = 2^(10) 
SIR = 13(10) 





MAXI 


1 
I 




1 

! 
i 


25U (%376) 


! 
MAXI 
1 


o (510) 


1 

1 ' 
1 ' 
1 

V 


255 (%377) 




GLOBAL RIN 
FLAG TABLE 



-maximum # of running jobs (# of bytes -3) 
-total number of free entries 



-free entry 
-allocated entry 



•free list terminator 



A JPCNT entry must be allocated before the main process can be 
procreated. 

The job SIR (PXGJSIR) = some base+JPCNT index. 

NOTE: This table is completely byte oriented with each entry 

consisting of one byte. Entries are taken from available pool 
on a "first found" basis. 25U (376 octal) in a byte denotes a 
free entry. 255 (377 octal) denotes the end of table. 

GLOBAL RIN FLAG TABLE 



This table is a bit table which immediately follows the "free list 
terminator" byte. It is initialized to and is indexed by JPCNT 
index for each job. When any process in a job/session locks a global 
rin, the appropriate bit is turned on. 
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JCUT - JOB CUTOFF TABLE 



1 Entry/ CPU-limited Job 



CORE RESIDENT 



SYSGLOB BASE = DB+11(%13) 
DST = 36(10) 
SIR = 1U(10) 

SYSGLOB + %117 = default 
CPU time limit for jobs 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 



FREE HEAD 



# OF REAL ENTRIES | ENTRY SIZE (3) 
POINTER TO LAST ENTRY (0) 



HEADER ENTRY 



JCUTCPUL 



JCUTCPUC 



TYPICAL ENTRY 

time limit 
(seconds) 

time count 
(msec) 



POINTER TO NEXT FREE ENTRY (END OF LIST = 0) 



LAST ENTRY 



FREE ENTRY 
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JIT -Job Information Table 



111111 



JIT DST is word 6 in PXGLOB 





nii : A,4l)i .e.<lT.p.i"ilf\.i .oil 


• li.C 


o 


not used - 1 


n 


6 : JIT DST | 


2| 


pointer to job info 


8 ! 


31 


pointer to acct info 


U8 | 


U| 


pointer to reserved area 


59 1 


5 


association table index | 


6 


:F| 


7 


not used 


10 


7 1 


11 


ty : job number 1 


12 


JITMAXP : JITMPN \ 


13 


EOF: not used I 


Ik 


DS DATASEG I 


15 
16 


JITGSEC (2 words) | 
group security I 


20 


JITHAN (k words) | 
account name 1 


2k 


JITHGN {k words) | 
home group I 


30 


JITLGN (k words) | 
log-on group I 



6 
7 



10 
11 
12 
13 
1U 

16 

20 

2k 



F - Job/Sess ion-wide 
FPMAP option flag 
(JSFPMAP) 

ty - 1 = Session 
2 = Job 



JITMAXP - MAXJOBPRI capability 

JITMPN - Job main PIN. 

JITEOF - used by FCLOSE to tell CI 
that a $STDIN(X) file was closed 
w/out encountering an EOF. 
(0:1)=$STDIN, (1:1)=$STDINX 



+ + 

0|1:2:3|U:5:6| 7:8:91 0:1:2|3:U:5 

111111 



8-7 



JIT - Continued 



111111 
0|1:2:3|1*:5:6|7:8:9|Q:1:2|3:1*:5 



3** I 

351 
36| 
371 



JITUN 
user name 



*»0 j pointer to JITAIP 



1»1|P|M: pointer to JITGIP 



1*2 1 

1*31 

I 

1*U| 

1*51 

I 

l+6| 

1*7 1 

I 
50| 
5H 
521 

I 
531 

I- 
5U| 
551 
56| 
571 

I- 



LATTR 
local attributes 



PASSF 
passed file pointer 



UCAP 
user capability * 



allow mask 



local RIN pointer 



JITJN 
job name 



53 



55 



28 
29 
30 
31 

32 

33 

3* 
35 

36 
37 

38 
39 

1*0 
1*1 
U2 

1*3 

1*1* 

1*5 
1*6 

U7 



+ + 

0|1:2:3|1*:5:6| 7:8:910:1 :2|3:1*: 5 

111111 



P - Group's home volume is 
a private volume 

M - Private volume mounted 

(i.e. group bound to home 
volume set), JITGIP = 57 



For bit mask definitions, see 
0PC0MMAND listing or COMSEARCH 
of segment CIINIT. 
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JIT - Continued 



111111 
|1: 2:31 U: 5:6| 7:8:91 0:1: 2| 3:^:5 



501 3 

I - " 

6l| JITCREC - # of creations 



I- 



62| 
631 



671 
70 1 

I 
711 
72 1 

i 
731 



7U| 
I 



JITCPUC 
cpu milliseconds 



6k\ not used : 
I- 

651 

66 I JITAIP 



HIPRI 




JITGIP 



HVTABX 



JITGIP 



1*8 

±9 

50 
51 

52 

53 
5U 

55 
56 

57 
58 

59 
60 



Accounting Info 



HIPRI - highest job priority 



System volume set 



Mounted private volume set 



0|1:2:3|U:5:6| 7:8:91 0:1:2| 3:^:5 

111111 



* THE FORMAT FOR UCAP (%U6-U7) IS AS FOLLOWS: 



W0RD1 
WORD2 



0| 1| 


2| 31 


m 


51 6| 71 8| 9llO|ll|12|13|lU|l5l 

_i 


SM|AM|AL|GL|DI|OP|CV|UV|LG| 


|CS|ND|SF| 
I 








|BA|IA|PM| 


|MR| | DS | PH | 

1 
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JDT - JOB DIRECTORY TABLE 



I MAX SEG SIZE(WDS) 

I 

1 | POINTER TO JDSD 



POINTER TO JTFD 



3 j POINTER TO JFEQ 



I 



U | POINTER TO JLEQ | 



I 



POINTER TO JJCW 



I 



6 j POINTER TO FREE SPACE j 

I 1 

WORK AREA 
15 words 



I 



JDSJNUM |TY| NUM j 
I — I 

I llllll III II I JSMPIN | 



JDSD 



JOB DATA 
SEGMENT DIRECTORY 



I 



1 entry per job 
DST # in PXGLOB 



job number 

main process number 



JTFD 



JOB TEMPORARY 
FILE DIRECTORY 



JFEQ 



JLEQ 



JOB FILE 
EQUATION TABLE 



JOB LINE 
EQUATION TABLE 



JOB CONTROL WORD 
TABLE (JJCW) 



FREE SPACE 



ENTRY 
SIZE 


INAME i 
(WDS)j SIZE (WDS)| 


CI 


1 C2 | 




CN 


1 (%Uo) | 


ENTRY j 
INFORMATION 1 



The name is a 
•| concatenation of up to 3 subnames. 
| Bit of the 1st character of each 
| subname is 1. 
I 
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JOB DATA SEGMENT DIRECTORY ENTRY - (IN JDT) 



1 2 3 h 5 6 7 8 9 10 11 12 13 l 1 * 15 
h I 1 



SEGMENT ID 



EXTRA DATA SEGMENT DST INDEX 
# OF PROCESSES ACCESSING 



JOB TEMPORARY FILE ENTRY - (IN JDT) 



l 2 3 U 5 6 7 8 9 10 11 12 13 l 1 * 15 
ENTRY SIZE (WORDS) | NAME SIZE (WORDS) | 

— - -i 



NAME-ACTUAL FILE DESIGNATOR 
VOLUME POINTER | 



FILE LABEL POINTER 



Name is a 

concatenation of up 
to three subnames. 
Bit of the first 
character of each 
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FILE EQUATION TABLE ENTRY - (IN JDT) 



1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 
I ENTRY SIZE (WORDS) | NAME SIZE (WORDS) j 



NAME 
(FORMAL DESIGNATOR) 




NAME -ACTUAL DESIGNATOR 
(may not be present) 



DEVICE/CLASS NAME 
(may not be present) 



FOPTIONS 



AOPTIONS 



#BUFFERS 



| INIT ALLOC |D |T |S 



# EXTENTS 



RECORD SIZE 

i mum i block factor 



FILE 
SIZE 



OUTPRI 



FILE CODE 
NUMCOPIES 



REF COUNT | # OF USER LABELS 
LENGTH FORMS=/LABEL= 



FORMS /LABEL 
ARRAY 



-disposition 
BIT13 DEL 
BITlit TEMP 
BIT15 SAVE 
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JOB LINE EQUATION ENTRY 



i ENTRY SIZE (WORDS) i DESIG. SIZE (WORDS) | 
I 



I— 

01 
| 

1| REF CNT 

I — 
21 

I — 
31 
I 

I 
51 

I 
61 

I-- 
71 

I 
10 1 

I 

111 

I 

12| 



FORMAL 
LINE DESIGNATOR 
(1-k WORDS) 



PMASK1 
5|P | PMASK2 



NAME LENGTH 



DEV LENGTH 



NAME 



( END OF LEQ ENTRY IF NON-BLANK ) 



DEVICE 



13 i 

I 

lk\ DRIVER NAME LENGTH 



PMASK3 



151 

I 
16| 

I 
171 

I 
20| 

I- 
21| 

I 
22 1 

I 
231 

I 

2U| 



DRIVER NAME 



LIST PNTR 
COPTIONS 



AOPTIONS 



DOPTIONS 



1 P=FLAG 
2 

3 
U 

5 
6 

8 

9 

10 

11 

12 
13 
Ik 

15 
16 

17 
18 

19 
20 
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JLEQ ENTRY (CONT.) 



251 



I 



26 

I 

271 

I 

311 

I 
331 

I 
3»»l 

I 
351 

I 
36| 

I 
371 

I 
h0\ 

I 

Ul| 

I 
U2| 



U3I 

I- 



NUMBER OF BUFFERS 
BUFFER SIZE IN WORDS 
INSPEED (2 words) 
OUTSPEED (2 words) 
POLL REPEAT 
POLL DELAY 
C TRACE INFO 
LOCAL ID PNTR 
REMOTE ID PNTR 
SUPLIST PNTR 
PHONE LIST PNTR 

POLLIST PNTR 
MISC ARRAY PNTR 



121 



22 



123 

I 

125 

I 

1 27 

I 

|28 

I 

1 29 

I 

130 \ 

I 

131 

I 

!32 

I 

133 

I 

I3U 

I 

135 / 



REL TO ORIG 
OF LEQ ENTRY 



JJCW 



JOB CONTROL WORD TABLE 



I NAME SIZE (BYTES) | 



I 



NAME 



TY 



MODIFIER 



MODIFIER = VALUE FROM TO #377777 



Name may be any alpha- 
numeric string, begin- 
ning with an alpha, 
between 1 and 255 char- 
acters long. 

TY 00 = OK 
01 = WARN 

10 = FATAL 

11 = SYSTEM 
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AOPTIONS AND FOPTIONS WORD BREAKDOWN 



OPTION WORD 2 
(AOPTIONS) 


OPTION WORD 1 
(FOPTIONS) 


oi — i 

i o j 


A 1 1 

Uj — | 

1 o | 


1 o | 


1 o | 


1 o | 

3 1 1 copy 


2| 
j j file type 

31 1 


h\ i no-wait 


i o | 


51 1 

| |multi- 
6\ | access 

7| | inhibit buff. 


5l j disallow file 

6 j | labelled tape 

| 1 carriage 

7 1 i control 


8| 

| | exclusive 

91 1 


81 1 
j | record format 

91 1 


10 j j dynamic locking 

j jmulti- 

11 | | record 


10 1 I 

i ! default 
| {designator 


12 1 | 


12 1 | 


| | access type 


13 j jascii/binary 


151 1 


1U| ! 

| | domain 

15 ! ! 
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PMASK WORD BREAKDOWN 



PMASK WORD 2 
PMASK WORD 1 



FILE TYPE 
LABELLED TAPE 
FRMS MESSAGE 
USER LABELS 

5 
POINTER ENTRY 
DYN. LOCKING- 
WAIT, NOWAIT 
MULTI ACCESS 
NUMCOP 
OUTPRI 
FILECODE 
FILESIZE 
NUMEXTS 
INIT ALLOC 



l->info 
0->info 






BLOCK FACTOR 
RECSIZE 
DISPOSITION 
NUMBUFFERS 
INHIBIT BUFFERING 
EXCLUSIVE 
MULTI -RECORD 
ACCESS TYPE 
COPY.NOCOPY 
CARRIAGE CONTROL 
RECORD FORMAT 
DEFAULT DESIGNATOR 
ASCII/BINARY 
DOMAIN 
DEVICE 
NAME 
15 



present 
absent 
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UCOP REQUEST QUEUE (DST#9) 



0| 
1| 
2 1 
31 



MAX# REQ ENTRIES N/2 
DOUBLE POINTER TO NEXT AVIL 



DOUBLE POINTER TO NEXT REQ 




REQ 1 
REQ 2 



N 

WRDSl 



REQ N 
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UCOP ENTRY FORMAT 

12-15 
I 

I IIIIIIIIIUIIIIIIIIIIIIUIIIIIIIUI I 2 

I 



I /////////////////////// I 
I 

0-7 



PIN 
8-15 



Request Codes 

null 

1 null 



2 process deletion 
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CHAPTER 9 RELOCATABLE OBJECT CODE 



USL FILES - GENERAL INFO 



* USL record length 128 words always. 

* Layout of doubieword disc addresses 



I- 



| WORD # ( 
25-BIT RECORD # I WITHIN RECORD | 



2k 25 



31 



* Hash links join all entries with the same hash key regardless of 
type. 

* Linear lists terminate with a zero link 

* Circular lists containing only the list head point directly to 
themselves . 

* Single-word disc addresses 



9-BIT RECORD # 



WORD # 
WITHIN RECORD 



8 9 



15 



Uninitialized fields are reserved for future use and should 
be set to zero. 



RECORD AND OVERALL USL FILE FORMAT 



o| 


LID ! 





1 


NE 


1 


2 


DL 


2 


3 


SUMDG 


3 


U 


NDG 


U 


5 


SABDL 


5 


6 


SAIPL 


6 


7 


j SASL 


7 









NOTE: 
LOADER ID S.A. = Starting Address 

NR. DIRECTORY ENTRIES 

DIR. LENGTH 

TOTAL DIR. GARBAGE 

NR. DIR. GARB. ENTRIES 

S.A. BLOCK DATA LIST 

S.A. INTERRUPT PROC. LIST 

S.A. SEGMENT LIST 

USL FILE FORMAT (CONT.) 
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10 

11 


1 FL | 


12 


SAAD | 


13 


ADL | 


lit 
15 

16 
17 


SAI 1 
IL | 


20 
21 


SAAI 


22 
23 


AIL | 


25 


TOTAL | 
I.G. | 


26| 


NIC- i 


271 




30 1 




31 1 




32 1 




331 




3U| 




351 




36| 




371 




1+0 1 




Ul | 


HL | 

o I 




• 1 




1 


1771 


HL ! 
9U 1 



8 


FILE LENGTH 


9 




10 


S.A. AVAIL. DIR. 


11 


AVAIL. DIR. LENGTH 


12 


S.A. INFO BLOCK 


13 




11+ 


INFO BLOCK LENGTH 


15 




16 


S.A. AVAIL. INFO 


17 




18 


AVAIL. INFO LENGTH 


19 




20 


TOTAL INFO GARBAGE 


21 




22 


NR. INFO GARB. E1W 


23 




21+ 




25 




26 




27 




28 




29 




30 




31 




32 




33 


HASH LINKS 



127 



USL FILES - GENERAL INFO (CONT.) 
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o — -— o 

I I 

I RECORD | 

I I 

l I 



177- 



-127 



DL 



ADL 



200--- — — 128 



j DIRECTORY | 



SAAD 



I 

| ENTRIES 

I 

I 



i AVAILABLE j 
j DIRECTORY | 
I I 



32K 
MAX 



I 

I 
IL 

I 
I 



SAI* 



I I 

| INFO | 

j (HEADERS) j 

j (CODE) j 



! 



SAAI 



AIL 
I 



| AVAILABLE 
j INFO 



FL-1 

*SAI MUST BE ON A RECORD BOUNDRY 



NOTE: ALL ADDRESSES IN RECORD ARE WORD 
ADDRESSES. 
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USL FILES - GENERAL INFO (CONT.) 



SASL---> 




•>| SEGL 

I 

| SEG.K 

I 
•-ISUBL 



I I 

I I 

I I 




SEG.B 




A \ 

K >SEGMENT NAME ENTRIES 

B / 



PROC C \ 

PROC A SUBPROGRAM 

MAIN / ENTRIES 



A \ 

3 I 
A | 

1 } SECONDRY ENTRY POINT ENTRIES 
A | 

5 / 



9-U 



DATA DESCRIPTORS, PASSED PARAMETERS 

U X 2 J H 5 O J O ^ J.U AA A£ J.J At O 

— H-I-H-I-H-H--I--I--I--I-I — 

I MODE | STRUCTURE | TYPE 



TYPE 



WORDS 



CODE 



NULL 







LOGICAL 


1 


1 


INTEGER 


1 


2 


BYTE 


1/2 


3 


REAL 


2 


U 


DOUBLE 


2 


5 


LONG 


3 


6 


COMPLEX 


U 


7 


LABEL (SPL) 




10 


CHARACTER 


N/2 


11 


LABEL (FORTRAN) 




12 


UNIVERSAL (MATCHES ANY TYPE) 




13 


STRUCTURE 






SIMPLE VARIABLE 







POINTER 




1 


ARRAY 




2 


PROCEDURE 




3 



MODE 



NULL 
VALUE 
REFERENCE 
NAME 




1 
2 
3 



NOTE: A descriptor of results in an automatic match. 
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GARBAGE 

1 
I///I NW 



ENTRY TYPE 



10 11 15 

NW - Number of words in this 

I | block 




ENTRY TYPE 1 



SEGMENT NAME 
1 



7 8 10 11 



15 



I//I 


NW 

H L 


1 1 1 






IA I///////I 


NC 


CHAR1 | 


I (VARIABLE # CHAR. 

1 • 


SEE NC) 1 


I CHAR. NC 


I////////////////I 


I SEGL | 


1 L | 


SUBL 





NW - Number of words in entry 
block 

HL - Hash link - points to next 
entry having the same 
hash code 

A - Activity bit 

if active 

1 if inactive 
(initialize to 0) 

Note: An inactive segment 

implies that all entry 
points are inactive 

NC - Number of characters in 
name. Max is 16 

CHAR. 1 - First character in 

variable field 
CHAR. NC - Last character in 

variable field 
SEGL - Segment link - points to 

next segment name 

entry 
SUBL - Subprogram link - points 

to next entry having 

the same segment name 
L - Last entry in list 

if not last 

1 if last 
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CLARIFICATION NOTES ON ENTRY TYPES 2 AND k 
WITH RESPECT TO SPL AND FORTRAN 



♦ENTRY TYPE 2 
SPL O.B. 



**ENTRY TYPE k *ENTRY TYPE 2 
SPL PROC FORTRAN MAIN 



**ENTRY TYPE U 
FORTRAN SUB. 



TPDB 



1.5 



1,2,3,U 



1.2.3.U 



TSDB 


TSDB 


TSDB 


TSDB 


NWPUST 


NWPUST 


NWPUST 


NWPUST 


5 

NWSDB 


NWO 


NWD 


NWD 



WHERE: TPDB = Total primary DB length in words 

TSDB = Total secondary DB length in words 
NWPUST = Number of words in "TRACE" array 
NWSDB = Number of words in secondary DB array 
NWO = Number of words in own array 
NWD = Number of words in data array 

Notes: 1. Does not include the length of the STLT 

2. Does not include the length of the FLUT 

3. Does not include the length of any common array 

U. Includes the length of any DB-allocated format array 

array 
5- Are not necessarily equal 



In general TPDB and TSDB are summations of storage allocated in the 
global area of the program's data segment. They are not, however, 
complete since the compilers are not aware of all storage actually 
allocated! The STLT and FLUT are examples of this since these tables 
are constructed by the segmenter. Common arrays also present a problem 
since their inclusion in TPDB and TSDB might cause their storage 
requirements to be counted more than once. 
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ENTRY TYPE 2 



OUTER BLOCK 

o 123U5678 10 11 15 



I//I 


NW | 2 | 


1 HL | 


1 A 


I C | I |///| NC | CHAR 1 | 


1 • 1 

1 (VARIABLE # CHAR. SEE NC) | 

| • 1 


1 CHAR NC I///////////////////I 


1 L 


SUBL | 


1 L 


SECL | 




SSA | 


1 SAC | 
| RELATIVE TO SAI (SEE RECORD 0) j 


1 F 


W | NWC | 


1 SE | 


I TPDB | 


I TSDB | 


I NWPUST | 


I NWD/NWSDB | 


1 T | 


NH | 


I SAH | 
j RELATIVE TO SAI (SEE RECORD 0) j 


I HDW | 
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ENTRY TYPE 2 (CONT.) 



HDW 



T | NH 



SAH 



HDW 



HDW 



NW - Number of words in entry block. 

HL - Hash link - points to next entry with 
same hash code . 

A - Activity bit. if active, 1 if inactive 
outer block. 

C - Callability bit set if entry point is 
uncallable . 

I - Priv mode bit - set if program unit is 
to be executed in priv mode.. 

NC - Number of characters in name. Max is 16. 

CHAR. 1 - First character in variable field. 

CHAR. NC - Last character in variable field. 

L - Last entry in list. 

if not last 

1 if last 
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ENTRY TYPE 2 (CONT.) 



SUBL - Subprogram link - points to next entry 
Entry having the same segment name. 

SECL - Secondary entry point list link. 

SSA - Program unit starting PB address. 

SAC - Starting 8FILE9 address of code 
module 

F - Set if fatal error 

W - Set if non-fatal error 

NWC - Number of words in code module. 

SE - Stack size estimate 

TPDB - Total number of words of primary 
DB to be allocated 

TSDB - Total number of words of secondary 
DB to be allocated. 

NWPUST - Number of words in trace array 
(PUST) 

NWD - Number of words in data array 
(FORTRAN) 

NWSDB - Number of words in secondary 
DB array (SPL) 

T - Terminating bit - set if last set of 
headers in entry 

NH - Number of headers 

SAH - Starting address of header (relative 
to SAI) 

HDW - Header (pointer) 
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ENTRY TYPE 3 
OUTER BLOCK - SECONDARY ENTRY POINT 

o 123U5678 10 11 15 

I//! NW ! 3 i 

— - i 

I HL I 

I A I C |//|//| NC I CHAR 1 I 

i • I 

I (VARIABLE # CHAR. SEE NC) | 

I • I 

I CHAR NC I //////////////////// I 

i L I SECL | 

I SSA I 

ENTRY TYPE U 
PROCEDURE 
12 3 U567 8 10 11 15 



I//I 


-1 — 


-1 1 

NW | k | 


I HL j 


|A | C| I| 


H| NC 


| CHAR.l | 


1 • 1 
| (VARIABLE # CHAR. SEE NC) | 

1 . 1 


j CHAR.NC 




1 ////////////////////////////// 1 


IL | 




SUBL | 


IL | 




SECL | 


I SSA | 
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ENTRY TYPE k (COHT.) 



SAC 



F | W| NWC 

SE 



TPDB 
TSDB 
NWPUST 
NWD/NWO 
P I NP | CM 

TN 
PARM.l 



(VARIABLE f OF FARMS. SEE CN) 



PARM. NP 
NH 

SAH 

HDW 



HDW 



ETC 
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ENTRY TYPE k (CONT.) 



NW - Number of words in entry block 

EL - Hash link - points to next entry with same hash code 

A - Activity bit. if active, 1 if inactive entry point 

C - Callability bit set if entry point is uncallable 

I - Priv mode bit. Set if procedure is to be executed in priv mode. 

H - Hidden entry point. Set if entry point will not be in 

library directory. 
NC - Number of characters in name. Max is 16. 
CHAR1 - First character in variable field. 
CHAR NC - Last character in variable field. 
L - Last entry in list 

if not last 

1 if last 

SUBL - Subprogram link. Points to next entry having the same segment 

Name 
SECL - Secondary entry point list link. 
SSA - Unit starting PB address 
SAC - Starting (file) address of code module 
F - Set if fatal error 
W - Set if non- fatal error 
NWC - Number of words in code module 
SE - Stack size estimate 

TPDB - Total number of words of primary DB to be allocated. 
TSDB - Total number of words of secondard DB to be allocated. 
NWPUST - Number of words in trace array (PUST) 
NWD - Number of words in data array (FORTRAN) 
NWO - Number of words in own array (SPL) 
P - Parm checker 

00 no checking. (Implies NP undefined, FN and PARM's absent) 

01 check procedure type. (Implies NP is undefined and PARM s 
absent ) 

10 check procedure type and number of PARM's (implies PARM's 
absent) 

11 check procedure type, number of PARM 's and type of each PARM. 
NP - Number of PARM's 

CN - Character count of PARM's 

TN - Terminating bit. Set if last set of headers in entry. 

NH - Number of headers 

SAH - Starting address of header 

HDW - Header (pointer) 
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ENTRY TYPE 5 
PROCEDURE - SECONDARY ENTRY POINT 

0123U5678 10 11 15 



//I 




NW 


— -1 1 

1 5 


HL 


A| 


C |//|H | 


NC 


I CHAR. 1 


(VARIABLE #CHAR. 


SEE NC) 




CHAR. NC 




1 //////// '//////// 


L 1 




SECL 





SSA 



NW - Number of words in entry block 

HL - Hash link - points to next entry with 
same hash code 

A - Activity bit. if active, 1 if inactive 
entry point 

C - Callability bit set if entry point is 
uncallable. 

H - Hidden entry point set if entry point 
will not be in library directory 

NC - number of characters in name, max 
is 16 

CHAR 1 - First character in variable field. 

L - Last entry in list 

if not last 

1 if last 

SECL - Secondary entry point list link 
SSA - Unit starting PB' address 
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ENTRY TYPE 6 
INTERRUPT PROCEDURE 



i 0|1 |2 13 IWri8 10 |11 151 


I//I NW 


1 6 I 


1 EL 1 


|A | IT |//| 


NC | CHAR.l I 


| (VARIABLE # CHAR. SEE NC) | 

1 * 


|A | IT |//| 


NC j CHAR.l I 


| (VARIABLE # CHAR. SEE NC) | 


j CHAR. NC 


I//////////////////I 


| IPL 1 


| DBS 1 


| SSA 1 


| SAC 1 


IF | W| 


NWC 1 


IT | 


NH 1 


j SAH i 


| HDW 1 




• 1 



I HDW 

ENTRY TYPE 6 (CONT.) 
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NW - Number of words in entry block 

HL - Hash link. Points to next entry 
with same hash code 

A - Activity bit. if active, 1 if 
inactive entry. 

IT - Interrupt procedure type number 

NC - Number of characters in name (maximum is 16) 

CHAR 1 - First character in variable 
field. 

CHAR NC Last Character in variable field 

IPL Interrupt procedure link 

DBS Number of words of DB storage 
required. 

SSA Unit starting PB' address 

SAC Starting (file) address of code 
module . 

F Set if fatal error 

W Set if non- fatal error 

NWC Number of words in code module 



T 



Terminating bit. Set if last set 
of headers in entry. 



NH Number of headers 

SAH Starting address of header. 

HDW Header (pointer) 
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ENTRY TYPE 7 



BLOCK DATA 



| 1 | 2 | 3 |U567!8 10|11 15 
___|.__| — 1___|____ | 1 

///I NW | 7 



HL 
A | F | W |///| NC | CHAR.l 



BLOCK DATA NAME 



CHAR.NC | /////////////////////// 
BDL 
CAL 
///////////////I NC | CHAR.l 

COMMON ARRAY NAME 



CHAR.NC | /////////////////////// 
T | NH 

SAH 

HDW 



HDW 
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ENTRY TYPE 7 (CONT.) 



CAL 
///////////////I NC | CHAR.l 



COMMON ARRAY NAME 



CHAR.NC | /////////////////////// 
T | NH 

SAH 



HDW 
ETC 



NW Number of words in block 

HL Hash link. Points to next entry with 
same hash code. 

A Activity bit. if active, 1 if inactive 
block. 

F Set if fatal error. 

W Set if non-fatal error. 

CHAR 1 First character in variable field. 

CHAR NC Last character in variable field. 

BDL Block data link 

CAL Common array length 

T Terminating bit. Set if last set of 
headers in entry. 

NH Number of headers. 

SAH Starting address of headers. 

HDW Header (pointer) 



9-18 



ENTRY TYPE 8 



PROCEDURE - SECONDARY ENTRY POINT 

0123U5678 10 11 15 

— I-I--I-I I I 

///I NW I 8 



HL 
A I C|//| H| NC I CHAR. 1 



(VARIABLE #CHAR. SEE NC) 



CHAR. 


NC 


1 lliilllllilllllllllil 


L ! 




SECL 




-1 1 

P 1 


NP 


SSA 
-1 1" 

1 


"I 

CH 


TN 


PARM. 1 



PARM. NP 



NW - NUMBER OF WORDS IN ENTRY BLOCK 

HL - HASH LINK - POINTS TO NEXT ENTRY 
WITH SAME HASH CODE 

a - Honvni Dix. u if aunvii, ± ±r xmh^xxva 
ENTRY 

C - CALLABILITY BIT SET IF ENTRY POINT IS 
UNCALLABLE 

H - HIDDEN ENTRY POINT. SET IF ENTRY 
POINT WILL NOT BE IN LIBRARY 
DIRECTORY 

NC - NUMBER OF CHARACTERS IN NAME. MAX 
IS 16 
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ENTRY TYPE 8 (CONT. ) 



CHAR 1 - FIRST CHARACTER IN VARIABLE LIST 

CHAR NC - LAST CHARTACTER IN VARIABLE 
LIST 

L - LAST ENTRY IN LIST 

IF NOT LAST 

1 IF LAST 

SECL - SECONDARY ENTRY POINT LIST LINK 
SSA - UNIT STARTING PB' ADDRESS 

P - PARM CHECKER 

00 NO CHECKING (IMPLIES NP UNDEFINED, 
TN AND PARMS ABSENT) 

01 CHECK PROCEDURE TYPE (IMPLIES NP 
IS UNDEFINED AND PARMS ABSENT) 

10 CHECK PROCEDURE TYPE AND NUMBER 
OF PARMS. (IMPLIES PARMS ABSENT) 

11 CHECK PROCEDURE TYPE, NUMBER OF 
PARMS AND TYPE OF PARM. 

NP - NUMBER OF PARMS 

CN - CHARACTER COUNT OF PARMS 

TN - PROCEDURE TYPE 
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ENTRY HEADER FORMAT 



SAH 



> I HEADER 



SAH 



SAC 



HEADER 



HEADER 



CODE 



HEADER 



SAH 



HEADER 



HEADER 



EACH ENTRY (EXCEPT SECONDARY ENTRY POINT ENTRIES) 
MAY DESCRIBE N> SETS OF HEADERS. THE HEADERS IN 
EACH SET MUST BE CONTINUOUS AND IN THE SAME ORDER 
AS THE HOW LIST DESCRIBING THE SET. 

THE CODE MODULE MAY BE PLACED IN ANY POSITION IN A 
HEADER SET. NOTE THAT IF THE CODE MODULE IS AT THE 
BEGINNING OF A SET, SAC = SAH. 

IF THE ENTRY HAS NO HEADER SET, THEN NH, SAH SEQUENCE 
IS ABSENT. 
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HEADER TYPE 



10 11 15 




PCALs HEADER TYPE 1 

0123U5678 10 11 15 



I//I 


1 — -1 

1 1 i 


! PBA | 


\i milium nc 1 


CHAR. 1 | 


1 • 1 


! CHAR. NC I////////////////////I 


I P 1 HP | 


CM | 


1 TN 1 


1 PARM. 1 | 


1 • 1 


1 PARM. NP I 



PBA - PB' ADDRESS OF LINKED LIST OF PCAL 
INSTRUCTIONS TO BE REPAIRED - LOWER 
Ik BITS USED AS NEGATIVE DISP. - BIT 
SET MEANS THAT WORD IS NOT A PCAL 
INSTRUCTION BUT A POINTER TO A SST 
LABEL OF "EXTERNAL" FORMAT - A 
LINK OF TERMINATES THE LIST - BIT 1 
SET MEANS THAT THE WORD IS TO BE 
INITIALIZED WITH THE PB ADDRESS OF 
THE PROCEDURE. 
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HEADER TYPE 2 



PB ADDRESSES 




PBA - PB' ADDRESS OF PB ADDRESS 
TO BE CORRECTED 



OWN/DATA VARIABLES 

1 

-I 

I//I w 

Bl PBA 



HEADER TYPE 3 



10 11 15 
— I 

I 3 



B 



PBA 



PBA - PB' ADDRESS OF OWN VARIABLE 
POINTER TO BE CORRECTED 
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HEADER TYPE k 



DSDB/OWN/DATA/VALUES 



1 
1 


10 11 
1 




15 


///I 


1 

NW | 


U 




LD 


B I 


IN 







INITIAL VALUES 



LD - LOGICAL WORD DISPLACEMENT 

IN OWN ARRAY FOR INITIAL VALUES 

B - BYTE BIT-SET IMPLIES THAT LD IS 
TYPE BYTE AND THAT THE FIRST 
WORD OF THE INITIAL VALUE BLOCK 
IS A COUNT OF THE NUMBER OF BYTES 
IN THE INITIAL VALUE BLOCK 

IN - INTERATION NUMBER - NUMBER OF 

TIMES THE BLOCK OF INITIAL VALUE 
IS TO APPEAR IN THE SECONDARY BD - 
1->N0 DUPLICATION, 
2- DUPLICATION, ETC 



HEADER TYPE 5 



PUST 



1 

__ 1 




10 11 15 
1 


//I 


NW 


1 

1 5 


PBA 



INITIAL VALUES 



PBA - PB' ADDRESS OF LINKED LIST OF 

POINTERS TO BE INITIALIZED WITH 
DB ADDRESS OF PUST (SAME LIST 
FORMAT AS FOR FORMAT STRINGS) 
A PBA of -1 INDICATES NO FIX-UPS. 



NOTE: ALL REFERENCES TO THE PUST INCLUDE THE FOUR -WORD HEADER THAT IS 
APPENDED BY THE SEGMENTER. THESE WORDS ARE NOT PRESENT IN THE 
HEADER; THEY ARE AUTOMATICALLY ALLOCATED AND INITIALIZED BY THE 
SEGMENTER. 
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HEADER TYPE 6 

GLOBAL VARIABLES 

1 7 8 10 11 15 
__| —| 1 

//I nw ! 6 

TN 
DBA I ///////// I NC 

CHAR.l | CHAR. 2 



CHAR. NC Mill Hill H till 



HEADER TYPE 7 



EXTERNAL VARIABLES 
0123U5678 

I--H-H-H-H- 

7/1 NW 



10 11 15 

—I 

I 7 



TN 
Ml///// I NC I 



CHAR. 1 



PBA-PB' address of linked lists 
of instructions to be repair- 
ed; lower 8 bits of inst. used 
as neg. displacement to next 
instructions link of 
terminates the list. 

M -Monitored variable bit; set 

itored by debug. 

DA -Logical word disp. in PUST; 
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EXTERNAL VARIABLES (Continued) 



CHAR. NC I//////////////// 



DA 
PBA 



PBA 



lower 8 "bits of word will be 
in it. with prim.DB address 
of variable ;DA is present 
if M=l. 

NOTE: PBA of -1 implies null list 
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HEADER TYPE 8 

PRIMARY DB 
1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 



-l-l-l- 
/l 


-l-l- - - 

1 1 1 1 1 

NW 


-1 -- 

1 


--I- 


8 


--I-- 


u I u 
0! 1 


1 u 1 u 
1 2 ! 3 


u 


u 

5 


u 
! 6 


u 

7 



u |U |U |U |u I//////////// 

N-51 N-l*j N-31 N-2| N-l I //////////// 



INITIAL VALUES 



U - ADDRESS BITS 

00 IF NO ADDRESS 

01 IF NO ADDRESS 

10 IF WORD ADDRESS IN SECONDARY DB 

11 IF BYTE ADDRESS IN SECONDARY DB 

N - NWPDB 

NOTE: INITIAL ADDRESSES THAT ARE 

SECONDARY DB ADDRESSES ARE 
RELATIVE (I.E., THEY ARE 
LOGICAL DISPLACEMENTS IN 
SECONDARY DB). 
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HEADER TYPE 9 



COMMON VARIABLES 

0123U5678 
l-l-l-l-l-l-l-l" 



ll\ 



NW 



10 11 15 

— I 

I 9 



NWC 
////////I NC I 



CHAR. 1 



CHAR. NC I /////// llll I llll 
Bl Ml NL 



LD 
DA 
PBA 



PBA 



I 
I 
NL 

I 

I 
I 



B| M| 



NL 
LD 



DA 
PBA 



PBA 
HEADER TYPE 9 (CONT.) 
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NWC - NUMBER OF WORDS IN COMMON ARRAY 

NC - NUMBER OF CHARACTERS IN COMMON 
NAME- IF BLANK COMMON k COM' 

DA - LOGICAL WORD DISP. IN PUST - LOWER 
8 BITS OF WORD WILL BE INIT. WITH 
PRIM. DB ADDRESS OF VARIABLE - NOTE 
DA IS PRESENT IF M = 1 

B - BYTE BIT 

IF THE PRIMARY DB POINTER TO BE 
ALLOCATED AND INITIALIZED AND LD 
ARE OF TYPE WORD 

1 IF TYPE BYTE 

M - MONITORED VARIABLE BIT - SET IF 
VARIABLE IS BEING MONITORED BY 
DEBUG 

NL - NUMBER OF ADDRESS LISTS FOR 
VARIABLE 

LD - LOGICAL DISPLACEMENT OF VARIABLE 
IN COMMON ARRAY 

PBA - PB' ADDRESS OF LINKED LISTS OF 
INSTRUCTIONS TO BE REPAIRED 
LOWER 8 BITS USED AS NEGATIVE 

DISPLACEMENT TO NEXT INSTRUCTION 
A LINK OF TERMINATES THE 
LIST 

PBA = -1 INDICATES NO FIX-UPS 
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HEADER TYPE 10 



LOGICAL UNITS 


l-l 1 



I//I 



10 li 15 

10 



BIT MAP 



BIT MAP - BIT MAP OF LOGICAL UNITS 
REFERENCED; BIT 
CORRESPONDS TO LU 0, ETC. 
(1 LESS THAN OR EQUAL TO LU 
LESS THAN OR EQUAL TO 99) 



FORMAT STRING 



HEADER TYPE 11 




__l 




10 11 15 
I 


//I 


NW 


I 

| 11 


PBA 


NC 


CHAR. 


1 1 


CHAR. 2 



CHAR. NC 



I//////////////// 



PBA - PB' ADDRESS OF LINKED LIST OF 
POINTERS TO BE INITIALIZED 
LOWER 1U BITS OF WORD USED 
AS NEGATIVE DISPLACEMENT TO 
NEXT POINTER - BIT SET 
MEANS THAT THE POINTER IS TO 
BE TYPE BYTE - A LINK OF 
TERMINATES THE LIST. 
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RL FILE FORMAT 



0| LID 


1| FL 


2| NS 


31 


j SAXL 
51 


61 

71 

10 1 

ll| 

12 1 


Ul| HL 

1 o 


1 


1771 HL 
1 9U 





1 

2 
3 

k 

5 
6 

7 
8 

9 
10 



LOADER ID 

FILE LENGTH (IN RECORDS) 

NR. SECTIONS 




S.A. EXTERNAL SET LIST 



II 



FREE MAP 




NS 




NOTE: UNINITIALIZED FIELDS ARE 

RESERVED FOR FUTURE USE AND 
SHOULD BE ZERO. 

NS+1 



•*"» R A WASH T.TRT D 



127 S.A. HASH LIST 9 1 * 



AVAILABLE 
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STORAGE MANAGEMENT 



FILE SPACE IS MANAGED IN TERMS OF 32 WORDS BLOCKS (k BLOCKS PER 
128 WORD RECORD) . 



FREE SPACE (BLOCKS) IS ACCOUNTED FOR IN A BIT MAP, WHICH IS 
PARTITIONED INTO RECORDS (2K BLOCKS PER SECTION). A INDICATES 
THAT A BLOCK IS USED, A 1 INDICATES THAT IT IS FREE. 



FILE SPACE IS ALSO PARTITIONED INTO 512 RECORD SECTIONS (6U MAX. 
SECTIONS, 2K BLOCKS PER SECTION, 1 MAP PER SECTION). THE NUMBER 
OF SECTIONS IN A FILE IS NS=(FL+511) & LSR(9). THE FIRST NS 
RECORDS FOLLOWING RECORD (RECORDS 1 TO NS) ARE RESERVED FOR THE 
SECTION MAPS. 



A COMPLETE FILE ADDRESS WOULD HAVE THE FOLLOWING CONFIGURATION: 



l 2 3 U 5 6 15 16 26 27 31 

I I I" I I 

! | SECTION | BLOCK | DISPLCMT | 



FILE (WORD) ADDRESS 
DOUBLE WORD 
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ENTRY POINT DIRECTORY 



HL 



LINK 



USED 



//////// 
//////// 



LINK 



USED 



//////// 
//////// 



USED 



//////// 
//////// 



THE DIRECTORY IS PARTITIONED INTO 95 HASH LISTS (SAME HASH 
FUNCTION AS USL); EACH HASH LIST IS A LINKED LIST OF RECORDS. 

EACH RECORD CONTAINS A SUCCESSOR LINK (RECORD #) AND A USED SPACE 
COUNT. A LINK OF TERMINATES A LIST. WHEN A RECORD IS VOID OF 
ENTRIES (USED=2), ITS SPACE IS RETURNED TO THE FREE STORAGE AREA. 
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TYPICAL DIRECTORY ENTRY 



12 3 U567 8 15 



— I — I — I — I I 

S I U I I I ///| NC I CHAR. 1 



CHAR. NC I////////////////////// 



S.A. INFO BLOCK 



S.A. ENTRY 
F I W I NW CODE 



LC I NP I CN 

TN 
PARM. 1. 



PARM. NP 



S - SECONDARY ENTRY POINT BIT - SET IF 
THE ENTRY POINT WAS ORIGINALLY A 
SECONDARY ENTRY POINT. 

U - UNCALLABLE BIT - SET IF ENTRY POINT 
IS UNCALLABLE. 

I - PRIVILEGED MODE BIT - SET IF CODE 
MODULE IS TO BE RUN IN PRIV. MODE. 

LC is (0:2). . .Level of Checking 

= No checking 

1 >= Check for procedure type 

2 >= Check for # parameters 

3 >= Check for parameter type 
NP is (2:6) is # parameters 
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PROCEDURE INFO BLOCK 



15 



NW INFO ! 


NW CODE | | 


# ENTRY POINTS | | 

S 1 

CODE MODULE | NWC | 

1 1 I 

EXTN LINK | J 


TPDB | | 


TSDB | | 


NWSDB | NWI 


HEADER | | 


HEADER | 1 


i 1 


HEADER j | 



ALL HEADERS FOR THE PROCEDURE ARE APPENDED TO THE INFO BLOCK. 
HEADER SETS (EXTERNAL LISTS) ARE LINKED BY INCREASING FILE 
ADDRESS; A LINK OF 7.17777777777D TERMINATES THE LIST. 



THE 
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HEADERS 



12 3 U567 8 

— I — I — I — I I" 

lll\ NW 



10 11 
— I — 



15 



F I W I 



NW CODE 



S.A. INFO BLOCK 



S.A. ENTRY 
PBA 
S I U I I |///| NC I 



CHAR. 1 





CHAR. NC 


1 IlllliUIIIIIIIIUIUII 


p 


| NP 


| CN 


TN 


PARM. 1 



PARM. NP 



F - SET IF FATAL ERROR 

W - SET IF NON -FATAL ERROR 

S - SATISFIED BIT - SET IF EXTERNAL IS 

SATISFIED WITHIN RL. 
U - UNCALLABLE BIT 
I - PRIVELEGED BIT 



ALL HEADERS ARE THE SAME AS IN A USL EXCEPT FOR THE PCAL HEADER. 
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CHAPTER 10 PREPARED OBJECT CODE 






FLAGS 





1 


MS 


1 


2 


GS 


2 


3 


SAG 


3 


U 


SAS 




5 


ISS 


5 


o 


IDLS 


D 


7 


MAXD 


7 


10 


SAE 


8 


11 


SSEG 


9 


12 


SADR 


10 


13 


SASTLT 


11 


ll» 


SAFLUT 


12 


15 


SAX 


13 


16 


SSTT 


lit 


17 


SATC 


15 


20 


SAPMAP 


16 


21 


SASI 


17 


22 


FLAGS2 


19 


23 


CKSUM 


19 


2k 




20 


25 




21 


26 




22 



PROGkAM rILjK FORMAT 

NUMBER OF CODE SEGMENTS 

GLOBAL SIZE (DB TO QI) IN WORDS 

GLOBAL AREA RECORD # 

SEGMENT SET RECORD # (EACH SEG. STARTS IN NEW 
RECORD) 

INITIAL STACK SIZE IN WORDS 

INITIAL DL SIZE IN WORDS 

MAX. DATA SEGMENT SIZE (DL TO Z) IN WORDS 

ENTRY POINT LIST RECORD # 

STARTING SEGMENT # 

PRIN. ENTRY PT PB ADDRESS 

DB ADR. OF STLT (-1 IF NO STLT) 

(STLT=Segment Length Table) 
DB ADR. OF FLUT (-1 IF NO FLUT) 



EXTERNAL LIST RECORD # 
PRIN. ENTRY PT SST # 
STARTING ADDRESS OF TRAPCOM' 
STARTING RECORD OF PMAP INFO 
STARTING RECORD OF SYMBOLIC ITEMS 

TOTAL CHECKSUM OF ALL SEGMENTS 

NOTE : ALL UNUSED WORD ARE RESERVED FOR 
FUTURE USE AND SHOULD BE SET TO 
ZERO. 
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27 
30 
31 
32 
33 

3U 



CST | CST 
o I 1 



CST | ////// 
n I////// 



P|S| 
I I 



SL 



P|S| SL 
I I r 



23 
2U 

25 
26 

27 
28 \ 



K 



PROGRAM FILE FORMAT (CONT.) 



CST REMAPPIMG ARRAY 



SEGMENT DESCRIPTER ARRAY 



P-PRIVILEGED MODE 

S-Segment STT format: 0=> old format, 1=> new (extended) format 

N=NS -1 

K=28 + (NS +1) & LSR (1) 

L=((28 + NS + (NS + l)fcLSR(l) + 127)/128)128 - 1 
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FLAGS 

i 2 3 h 5 6 7 8 9 10 ii 12 13 in 15 
H-l-l-l-l-l-l-l-l-l — 1 — 1 — l — l — I — l 

|FjW |Z |P |//|//| |BA|IA|PMi 1 I MR|///| DS| PH 

F - FATAL ERROR IN PROGRAM 
W - NON-FATAL ERROR IN PROGRAM 
Z - ZERO UNIT DL AREA 

P - SET IF ANY SEG IS PRIV. (IF NOT SET NORMAL* 
NONPRIV MODE) 



CAPABILITIES 

/ BATCH ACCESS (9) [BA] 

INTERACTIVE ACCESS (8) [IA] 

PRIVILEGED MODE (7) [PM] 



ACCESS TO 

GENERAL 

RESOURCES 



MULTIPLE RINS (U) [MR] 

EXTRA DATA SEGMENT (2) [DS] 
PROCESS HANDLING (i) [PH] 
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FLAGS2 



1 2 3 *» 5 6 7 8 9 10 11 12 13 lU 15 
|-|-|-|-|-I"l"l"l"l"| — I — I — I — I — I — I 

|T|K I RESERVED j 



T - PATCH AREA EXISTED IN ALL CODE SEGMENTS 
K - CHECKSUM VALID 
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CST REMAPPING ARRAY 



CONTAINS THE LAST CST NUMBERS ASSIGNED TO THE SEGMENTS; 
INDEXED BY SEGMENT NUMBER. WHEN A PROGRAM FILE IS 
PREPARED, THE ARRAY IS INITIALIZED TO 0, l...,N. 
THIS ARRAY IS USED TO RE-ESTABLISH INTRA=PRQGRAM 
LINKAGE WHEN THE PROGRAM IS LOADED. 

SEGMENT DESCRIPTER ARRAY 



CONTAINS THE SEGMENT LENGTH AND A FLAG INDICATING IF THE 
SEGMENT IS TO BE LOADED IN PRIV. MODE. INDEXED BY 
SEGMENT NUMBER. ALL SEGMENTS BEGIN ON A RECORD BOUNDARY. 
THE NUMBER OF RECORDS FOR A GIVEN SEGMENT IS (SL + 127) 
& LSR(7). THE RECORD NUMBER, SAS, OF SEGMENT N IS 



SAS:=0 

FOR 1=0 TO N-l 

BEGIN 

SAS:=SAS + (SL(I) + 127)&LSR(7) 

END 



GLOBAL AREA FORMAT 



A SET OF RECORDS CONTAINING THE INITIAL VALUES FOR THE 
GLOBAL AREA OF THE DATA SEGMENT. THIS SET BEGINS AT 
RECORD SAG (WORD 3) AND CONSISTS OF (GS + 127) & LSR(7) 
RECORDS. 
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EXTERNAL LIST 



7 8 



15 



///|NC j CHAR 1 



CHAR NC|//////// 


NR 


STT # | SEG # 



STT # | SEG # 

-I 

LC| NP | CN 



TN 
PARM 1 



PARM NP 



TYPICAL ENTRY 



CHECK 



\ 
I 
I 
I 



NP 



CHECK 



1&2 



CHECK 3 



LIST TERMINATER 



LC (0:2) = LEVEL OF CHECKING 

= NO CHECKING 

1 >= CHECK FOR PROCEDURE TYPE 

2 >= CHECK FOR # PARAMETERS 

3 >= CHECK FOR PARAMETER TYPE 
NP (2:6) IS # PARAMETERS 
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ENTRY POINT LIST 



!////! NC ! CHAR 1 ! 



CHAR NC \UH I II 1 1 



P.B. ADR 
STT # 



I////I 


NC 


I CHAR 1 | 


j CHAR 


NC 


I/////////I 


1 


P.B. 


ADR | 


| STT # | 


l 




o ! 



LIST TERMINATER 



NOTE THAT THE ENTRY POINT LIST MUST IMMEDIATELY 
FOLLOW THE EXTERNAL LIST. 
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THE CODE SEGMENT WITH PATCH AREA 




PATCH AREA 



PROGRAM 
NAME 



SEGMENT 
NAME 



// 
CHECKSUM 



PREP TIME 
PATCH TIME 



PATCH 
AREA 



PALEN 



STT 



U-WORD PROGRAM NAME 

8 -WORD SEGMENT NAME 

1-WORD UNUSED 
1-WORD CHECKSUM 
2 -WORD PREP TIME 
2-WORD PATCH TIME 



1-WORD PATCH AREA LENGTH 
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PMAP INFO 




PTTL 
LPRO 
LPR1 



PMAP TYPE TABLE 



SEGMENT PMAP POINTERS 



ACTUAL PMAP DATUM 



PMAP TYPE TABLE 



LPRn 



TYPE TABLE LENGTH 

LENGTH OF PMAP RECORD TYPE 

LENGTH OF PMAP RECORD TYPE 1 



LENGTH OF PMAP RECORD TYPE n 



NOTE : n = PTTL - 2 
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PMAP RECORDS 



TYPE SEGMENT PMAP RECORD 






i 2 ; 


3 U 5 


6 7 8 


9 1 2 3 U 5 






o| 


NC 


char 1 | 


J • 1 




char 


NC 


I///////////////I 




STT 


LEN 


1 


SEG NUM j 






SEG 


LENGTH 





TYPE 1 PROCEDURE PMAP RECORD 



0123 1 »567890123 1 *5 
1| NC | char 1 



char NC 



I/////////////// 



H | ///////////////////////////// 
SA OF CODE 



CODE LENGTH 
PRIMARY ENTRY POINT ADDR 



COBOL TOOL BOX ID 
LINK 



TOOL BOX PROCEDURE ID 
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TYPE 2 SECONDARY ENTRY PMAP RECORD 



1 2-3 1* 5 


67890123U5 


1 2| 


NC | char 1 1 


i • 1 


j char NC 


I///////////////I 


1 H I UlillllUIIIUilllllllllllll 1 


| SECONDARY 


ENTRY POINT ADDR | 


| NUMBER 


OF ENTRY POINTS | 



H : HIDDEN ENTRY FLAG 
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SL FILE FORMAT 



0| LID 

1| FL 

2 1 EL 

31 

U| NSEG 

51 

6| 
7 I FRTL 
10 1 

111 NRT 
12 i 

131 NS 
1U| 

1*1 1 HLO 

177IHL9U 



1 FILE LENGTH (IN RECORDS) 

2 EXTENT LENGTH (IN RECORDS) 
3 

U # SEGMENTS 

5 
6 

7 S.A. OF FREE R.T. ENTRY LIST (-1 IF NONE) 

8 

9 # REFERENCE TABLE ENTRIES 

10 

11 # SECTIONS 

12 



33 



NOTE: 

SHADED AND UNITIALIZED FIELDS ARE 
127 RESERVED FOR FUTURE USE AND 

SHOULD BE ZERO. HL = HASH LIST. 
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I RECORD | 
I | 



SL FILE FORMAT (CONT.) 



I I 

| RECORD | <• 

I 1 I 



-- REFERENCE TABLE POINTERS 



I I 

| FREE MAP | 
I | 



NS+1- 



I I 

j FREE MAP | 

I NS-1 j 

I ! 



NS+2 
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STORAGE MANAGEMENT 



FILE SPACE IS MANAGED IN TERMS OF 128 WORD BLOCKS (1 BLOCK PER 
128 WORD RECORD) . 

FREE SPACE (BLOCKS) IS ACCOUNTED FOR IN A BIT MAP, WHICH IS 
PARTITIONED INTO RECORDS (2K BLOCKS PER SECTION). A INDICATES 
THAT A BLOCK IS USED; A 1 INDICATES THAT IT IS FREE. 

FILE SPACE IS ALSO PARTITIONED INTO 20U8 RECORD SECTIONS (l6 
MAX. SECTIONS, 2K BLOCKS PER SECTION 1 MAP PER SECTION). THE 
NUMBER OF SECTIONS IN A FILE IS NS=(FL + 20U7) & LSR(7). THE 
FIRST NS RECORDS FOLLOWING RECORDS 0, 1 (RECORDS 2 TO NS+1) 
ARE RESERVED FOR THE SECTION MAPS. 

IF THE SECTION MAPS SPECIFY MORE SPACE THAN IS POTENTIALLY 
AVAILABLE, THOSE RECORDS BEYOND FLIMIT ARE MARKED AS "USED". 



ENTRY POINT DIRECTORY 



I HL | 



LINK 



USED 



///////// 
///////// 



LINK 



USED 



IIIIUIII 
llillllil 



USED 



IIIIUIII 
IIIIUIII 



THE DIRECTORY IS PARTITIONED INTO 95 HASH LISTS (SAME HASH 
FUNCTION AS USL); EACH HASH LIST IS A LINKED LIST OF RECORDS. 

EACH RECORD CONTAINS A SUCCESSOR LINK (RECORD #) AND A USED SPACE 
COUNT. A LINK OF TERMINATES A LIST. WHEN A RECORD IS VOID OF 
ENTRIES (USED=2), ITS SPACE IS RETURNED TO THE FREE STORAGE 
AREA. 

THE HASH LIST HEAD POINTERS (HL IN THE DIAGRAM ABOVE) ARE IN RECORD 
WORDS %kl TO 7.177- 
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TYPICAL DIRECTORY ENTRY 



1 2 3 ** 


5 


6 


7 8 9 10 11 12 13 lU 15 


I///I u I///I P 1 


NC 




| CHAR 1 I 


i • • 


| CHAR NC 






1 IlilliUllllilllUIIIIIUIIilli 1 


| STT # 






| SEG # I 


I LC | NP 






| CN ! 


| TN i 


| PARM 1 1 


* 


i 
i 






PARM NP ! 



LC is (0:2). . .Level of Checking 

= No checking 

1 >= Check for procedure type 

2 >= Check for # parameters 

3 >= Check for parameter type 
NP is (2:6) is # parameters 

P - 0= Not permanently allocated 
1= Permanently allocated 

U - Uncallable bit - set if entry 
point is uncallable. 
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CODE SEGMENT LINKAGE STRUCTURE 



CODE SEGMENT 



STT MAP ARRAY 



EXTERNAL LIST 



EACH CODE SEGMENT OCCUPIES AN INTEGRAL NUMBER OF RECORDS. THIS BLOCK 
OF INFORMATION CAN BE SUB-DIVIDED INTO THREE TABLES: THE CODE SEGMENT 
PROPER, AN STT SEGMENT MAP ARRAY, AND AN EXTERNAL LIST. 



STT MAP ARRAY 

A 1 BYTE X 256 BYTE ARRAY. IT IS INDEXED BY STT NUMBER AND RETURNS 
(IF THE STT CORRESPONDS TO AN EXTERNAL OF THE SEGMENT) THE SEGMENT 
NUMBER OF THE EXTERNAL AND 255 OTHERWISE. THIS ARRAY IS USED WHENEVER 
THE SEGMENT IS LOADED AND IS UPDATED WHENEVER THE SL IS BOUND BY THE 
SEGMENTER. 



EXTERNAL LIST 

A SYMBOLIC LIST OF THE EXTERNALS OF THE SEGMENT. EACH ENTRY CONTAINS 
INFORMATION ABOUT THE EXTERNAL: PARAMETER CHECKING LEVEL AND PARAMETER 
MATCHING INFORMATION, AND THE SEGMENT NUMBER AND STT NUMBER IF THE 
EXTERNAL IS SATISFIED WITHIN THE SL. 
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CODE SEGMENT LINKAGE STRUCTURE (CONT.) 



12 3 U567 8 



15 



I — I — I — I 1 - 



CODE SEGMENT 



STT MAP ARRAY 



Sl/I/I/I NC I CHAR. 1 



CHAR. NC |//////////// 
STT # I SEG. # 



P I NP I CN 
TN 
PARM. 1 



PARM. NP 



S - SATISFIED BIT - SET IF EXTERNAL 
IS SATISFIED WITHIN SL 



EXTERNAL LIST TERMINATOR 
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REFERENCE TABLE STRUCTURE 



FOR EACH SEGMENT THERE IS A REFERENCE TABLE ENTRY OF 32 WORDS. THE 
REFERENCE TABLE ENTRIES ARE PACKED FOUR TO A RECORD. THE RECORDS 
CONTAINING THE REFERENCE TABLE ENTRIES ARE LISTED IN RECORD 1. THE 
RECORD CONTAINING REFERENCE TABLE ENTRY N IS REC 1 (N.(0 : lU))*, THE 
FIRST WORD OF THE ENTRY IS REFTAB (N. (lU : 2) & LSL (5)). 

WHEN A SEGMENT IS DELETED, THE REFERENCE TABLE ENTRY CORRESPONDING TO 
THE SEGMENT IS RELEASED. THESE FREE ENTRIES ARE LINKED TOGETHER IN A 
LIST; THE SEGMENT # IS USED AS A LINK AND IS PLACED IN THE FIRST WORD 
OF THE ENTRY. 

WHEN A SEGMENT IS ADDED IT IS ASSIGNED A SEGMENT NUMBER (0 LESS 
THAN/EQUAL TO N LESS THAN/EQUAL TO 25^) ; THE NUMBER IS THAT OF THE 
FIRST FREE REFERENCE TABLE ENTRY, OR, IF NONE ARE FREE, THE NEXT 
AVAILABLE REFERENCE TABLE ENTRY (CAUSING SPACE ALLOCATION FOR THE 
ENTRY). 
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DREC. 1 



I RL |-->l 



i 



R.T. REC. 

E 
n 



REFERENCE TABLE (256 MAX. ENTRIES) 
TYPICAL ENTRY 

15 



I-: 



i 



J J 

1 1 

I I 

I I 

I I 



I 



RL I 
63 I 



(FILE REC1) (1 SECTOR) 

SEG.NAME -16 BYTE ARRAY 
WITH NO CHARAC- 
TER COUNT AND 
TRAILING BLANKS 
ADDED. 

REF.MAP -256 BIT ARRAY 

(INDEXED BY SEG#); 
BIT SET IF SEG IS 
REFERENCED DIRECT- 
LY OR INDIRECTLY. 

F SEGMENT DELETED 

S EXTERNAL SATISFIED 

A PERMANENTLY ALLOCATED 

C CORE RESIDENT SEGMENT 

X MPE SEGMENT 

P PRI V.INST. IN SEGMENT 

N SLSEGFLAG 

T PATCH FLAG ! 

K CHECKSUM FLAG ! 

1 

I 

SLSEGFLAG: I 

= => SEG STT IS IN j 

OLD FORMAT | 

= 1 => SEG STT IS IN j 

NEW FORMAT — | 

EXTENDED CSTS | 



0123U56789 

-H-H-H-H-l 

P|N| SEGMENT LENGTH 



SEGMENT ADDRESS (REC. #) 
# REC'S FOR SEG. & EXTN. LIST 
F|S|/|/|A|C|X|/|/| # ENTRY PTS. 
SAPMAP 
SASI 
T|K| 



SEGMENT NAME 



REFERENCED SEGMENTS 
BIT MAP 



% 


1 
2 
3 
h 

5 
6 

7 
10 



20 
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THE CODE SEGMENT WITH PATCH AREA 




PATCH AREA 



SEGMENT 
NAME 



II 
CHECKSUM 



PREP TIME 
PATCH TIME 



PATCH 
AREA 



PALEN 



STT 



8 -WORD SEGMENT NAME 

1-WORD UNUSED 
1-WORD CHECKSUM 
2 -WORD PREP TIME 
2 -WORD PATCH TIME 



1-WORD PATCH AREA LENGTH 
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PMAP INFO 




PMAP TYPE TABLE 



ACTUAL PMAP DATUM 



PTTL 



LPRO 
LPR1 



LPRn 



PMAP TYPE TABLE 



TYPE TABLE LENGTH 

LENGTH OF PMAP RECORD TYPE 

LENGTH OF PMAP RECORD TYPE 1 



LENGTH OF PMAP RECORD TYPE n 



NOTE : n = PTTL - 2 
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PMAP RECORDS 



TYPE SEGMENT PMAP RECORD 



12 


3U567890123U5 




o| 


NC | char 1 | 


1 * 1 


| char 


NC 


I///////////////I 


| STT 


LEN 


| SEGNUH | 




SEG 


LENGTH j 



TYPE 1 PROCEDURE PMAP RECORD 



0123U567890123U5 
1| NC I char 1 



char NC 



I/////////////// 



H|///////////////////////////// 
SA OF CODE 



CODE LENGTH 
PRIMARY ENTRY POINT ADDR 



COBOL TOOL BOX ID 
LINK 



TOOL BOX PROCEDURE ID 
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TYPE 2 SECONDARY ENTRY PMAP RECORD 



Q 1 2 3 k 5 


6?890123 1 *5 


1 2| 


NC | char 1 j 


! • ! 


j char NC 


I///////////////I 


1 H | ///////////////////////////// 1 


| SECONDARY ENTRY POINT ADDR | 


| NUMBER 


OF ENTRY POINTS | 



H : HIDDEN ENTRY FLAG 
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CHAPTER 11 LOADER 



GENERAL INFORMATION 



The first area of the CST, pointed to by absolute 0, contains system 
and library segments. Its size is configurable but it may not contain 
more than 191 entries. This area is assigned CST numbers l-%277- The 
second area is used for programs. The total number of entries in this 
area is not hardware limited. This area is allocated a block at a 
time with one program per block. A block may contain from 1 to 63 
segments, which will be assigned CST entry numbers Jl301-%377. The 
maximum number of segments in a program file is 63 and segments of 
different programs will have the same CST number. Thus both a block 
number and a CST# are required to uniquely identify a program segment. 
A fallout of this is that logical segment=physical CST-%301. 

The loader is a system process which will do loads sequentially. 
If a process needs code to be loaded, it will get the load process' 
SIR, fill a communication data segment and then awake the loader. 
Upon completion, the loader will return its status through the 
communication data segment and then activate the waiting process. 
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LOADER SEGMENT ALLOCATION 



The order in which storage is allocated for arrays is arbitrary, with 
one exception: The storage for array DIR must be last in the data 
segment. This allows the data segment expansion/contraction intrinsics 
to be applied so that DIR storage may be dynamically allocated. 







DATA LABELS 


fnR+^ 




REF TAB 
(ref count) 


\LtB-T3) 




/TYR-4-M 




XFORM 






fTYR+^> 




ENT TAB 


\UD-r'}) 








SBUF 






SBUF 1 






SBUF 2 






SBUF 3 






SBUF U 


/r»R4-9^ 








- 


DIR 



PRIMARY DB 

REFERENCE COUNT TABLE 

SEGMENT TRANSFORM TABLE 
ENTRY INDEX TABLE 



\ 
I 



I 



> UTILITY BUFFERS 
(128 words each) 



DIRECTORY 
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o 


UTILITY INTEGER | 


1 I 

j. j 


DIRECTORY LENGTH | 


2 1 


ENTRY TABLE POINTER | 


31 


REFERENCE COUNT TABLE | 
POINTER j 


U| 


CST TO LCST AND FLAG j 
TABLE POINTER j 


5 


CST TO ENTRY INDEX I 
TABLE POINTER | 


6 


SECONDARY ENTTAB | 
POINTER | 


7 


ENTRY POINTER | 


10 


SECONDARY ENTRY | 
POINTER 1 


11 


SECOND RECORD DISC | 
BUFFER POINTER j 


12 


ll 1 


13 


II I 


11* 

15 


II | 
ll I 


16 


UTILITY INTEGER 1 


17 


II 1 


20 


1 " \ 


21 


" \ 


22 


i ll 1 


23 




2U 


i " 1 


25 


1 " 1 


26 


1 " 1 



LOADER SEGMENT TABLE PRIMARY DB (DST f.22) 
SO 

DIRLEN 
DIR 
REFCOUNT 

XFORM 

ENTTAB 

ENTP2 

ENTP 
ENTP1 

SBUFO 

SBUF1 

SBUF2 

SBUF3 

SBUFl* 

SI 

SJ 

SK 

SL 

SM 

SN 

SP 

| 

SQ 271 

I 

SR 30 1 



I 

1ST 
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REFERENCE COUNT TABLE 
(DB + 3) 



Indexed by CST number; contains the 
reference count for each code seg- 
ment. Contains -1 if the CST 
entry is not allocated. 



SEGMENT TRANSFORM TABLE 
(DB + U) 



LEFT 
BYTE 



RIGHT 
BYTE 



| LOG CSTlj FLAGS 
I 

XFORM 



Indexed by CST number; contains the 
file-relative (logical) segment 
number and segment attributes. 



I 0| l| 2| 31 U| 51 61 71 8| 9ll0|ll|12|13|ll»U5l 
|..|._|..|..|_.|-_|_.|..|..|..|..,_.|„|„|..|_.| 

I SEG# | T | A| C| X|////////| 



T-Segment Type: 



I-- 

System SL =0 
Public SL =1 
Group SL =2 
Program Seg =3 



l-l-l-l 



I 



A-Perm. Allocated Segment (1/0) 
C-Core Resident Segment (1/0) 
X-System (MPE) Segment (1/0) 
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ENTRY INDEX TABLE 
(DB + 5) 



I I 

| j Indexed by CST number; contains the 

| ENT TAB j directory index of the file entry 

j j corresponding to the CST number, 

I I 

I I 



DIRECTORY 
(DB + 2) 



Accessed by entry key - contains vari- 
able length entries, each entry describ- 
ing a set of CST numbers. 



The directory is completely filled with variable length entries. The 
empty state is represented by a single garbage entry. It is accessed 
by a sequential search using a double word entry key, or by direct 
indexing using ENTTAB, 

The first word of each entry has the same format and includes an entry 
type number. In addition, most entries (all entries except type 
garbage) have an implicit double word entry key. Those entries that 
have an explicit single word key have an additional word that is 
implicitly 0. The entry key immediately follows the entry descriptor 
(first) word. 

For file entries, the key is the double word sector number of the file 
label with the first byte of the double word replaced with the logical 
device number. For process entries, the key is the single word PIN 
with the first byte of the single word replaced with the extension 
number (LOADPROC id number) . 
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ID1 



ENTRY POINTER (ENTP) 



(DB + 7) 



2 
3 
k 

5 
6 



o| 


11 


2| 


31 U| 51 6| 71 


8| 9ll0|ll|12|13|lU|15 








1 A| 


LS | F| P| 


1 


ET 






#wds in garbage entry /pro cess 


id 










Second word 


of file ID 












Working set 


pointer 












CST block 


index 






Prog file reference count 








#Segments 


in file 







ENWG,EPID*,EF 

EF102 

EWSP 

ECST 

ESHR 

ESEG 



A = Program Allocated 
LS = Library Search 
F = File Mode 
P = Program Mode 
ET = Entry Type 

*EPID 



I 0| l| 2| 31 Ui 51 6| 71 8| 9U0|ll|12|13|lU|15l 
| .__ | 

| EXTENSION NUMBER | PIN NUMBER | 

I I 



EFID1 = First word of file ID 
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SBUFO (DB + 9) 



I nl 1 I ol -a I )il el CI "7 1 fit QlinliilioH'al-ihlicI 

I— " 

I F| N| Z | //////// | CAP LIST 



2 

3 
k 

5 
6 

7 
10 
11 
12 

13 

1U 

15 
16 

17 



Number segments 
Global area size 



REC. NR. of global area 
Rec. nr. of segment list 



Stack size 
DL size 



Max. data seg. size 
Rec. nr. of entry point list 



Starting segment nr. 
Starting PB address 



Starting address of STLT 
Starting address of FLUT 



Rec. Nr. of external list 

Starting SST Nr. 
Starting address of trapcom. 



STAGS 

SNRSEGS 

SGLOBALSIZE 

SGLOBALRECD 

SSEGMENTRECD 

SSTACKSIZE 

SDLSIZE 

SMAXDATA 

SENTRYRECD 

SSTARTINGSEG 

SSTARTINGADR 

SSASTLT 

SSAFLUT 

SEXTERNALRECD 

SSTARTINGSST 

SSATRAPCOM 



F = Fatal Error 

N = Non-Fatal Error 

Z = Zero DB 
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DIRECTORY ENTRIES 



INWG 



16 



I 
20 

I 
21 



0| 1| 2| 31 U| 51 6| 71 8| 9llO|ll|l2|13UU|15 



I I I I 



NWG 



GARBAGE 



|10|11|12|13UU|15 
l-l-l-l 



I M| | | 1 
.|-|--|--| 



-FID- 



PVINFO 



CSTARRAY 



7| 9 |10|ll|12|13|lU|15 
l-l-l-l 



| A| LIB | M| P| | 2 



l-l-l-l 



l"|- 
-FID- 



CST block index 



fprocess sharing 



fsegments in prog, file 



FVINFO 



IllllllfllllllllllllUIIIIUIIIIIIIIIIUUIIIII 
HlUIUIIIUilllllillllllllillllililllllUllil 

CST bit map 

IIIIIIIIIUIIIIUIIUIIIIIIUIIIIIIUIIIIIIIIII 

imiiiiuuiiuiiiiiiiiiiiiiiiiiiniiiiiiiiiii 



GARBAGE (0) 



1 FREE SPACE 



SL FILE(l) 

— - 

Indicates which 

1 CSTs are being 
used for the 

2 segments of the 
SL file. 

3 FVINFO: $ 
0:U- unused $ 

U lt:U- MVTAB inx $ 
8:8- vols mtd. % 
(master=bit 15)$ 



Program File 
Directory (2) 

1 Indicates which 
CST's are being 

2 used for the 
segments of the 

3 program file and 
its internals. 
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A: set if program file is allocated 
DIRECTORY ENTRIES (CONT. ) 



I 
3 



k 
I 



|10|ll|12|l3|lU|15 

■I--I--I-I 

! M| P| ! 3 

i-i-i-i 



-FID- 



|10|ll|12|13U 1 t|l5 

I-I-I--I 

I M| P| | k 
l-l-l-l 



-FID- 



CREATER PIN 
(NOT USED) 



0| 1| 2| 31 H| 51 6| 71 8| 9U0|ll|l2|13|lU|15 

--I I —I — l-l-l-l 

I M| P| I 5 



-FID- 



LOAD PROCESS STATUS 



|10|ll|12|13U*t|15 

l-l-l-l " 

I M| P| | 6 

l-l-l-l 

PIN 



-FID- 



LOADING (3) 



1 Indicates that 
the program 

2 file is being 
loaded . 



WAITER(U) 



Indicates that 
a process is 
waiting for the 
program file to 
be loaded. 



LOADED(5) 



1 Indicates that 
a program file 

2 has been loaded 



SHARER (6) 



Indicates that 
a process is 

2 running the 
program file. 

3 
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DIRECTORY ENTRIES (CONT. ) 



I 
I 
I 
I 
Ik 

I 
I 
I 

I 



12 



1 11 1 12 1 13 1 lU| 15 

I--I--I 

I I F| 7 



EXT 



PIN 



CST ARRAY 



0| 11 2| 



176177 



EXTENSION(7) 



Indicates that 
a process has 
loadproced a 
procedure . 



CST ARRAY (BIT MAP) 



DEFINITIONS 



NWG 



fwords in garbage entry. 



FID - file ID. 

word l-(0:8)=log dev# 

word l-(8:8)=msb of disc address 

word 2-=lsb of disc address 

LIB - 0=SSL, 1=PSL, 2=GSL. 

F - CST array format (0=list, l=bit map) 



M - executing mode, indicates whether the segments for the file 
have been copied onto the system disc (l=fast) or not (slow). 
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DEFINITIONS (CONT.) 



rn 
X 


entry type 





GARBAGE 


X 


SL 


2 


PROGRAM 


3 


LOADING 


U 


WAITING 


5 


LOADED 


6 


SHARER 


7 


EXTENSION 



self explanatory 

indicates which CST's are being used for segments 

of the file. Currently F=l and M=0 for all 

SL entries. 

indicates which CST's are being used for segments 

of the file and all its externals. Currently 

M=0 for all program entries. 

indicates that a program file (FID) is being 

loaded on behalf of a process (PIN). 

indicates that a process (PIN) is waiting for 

a program file (FID) to be loaded. 

transformed entry of type k that is used to 

return status of load. 

indicates that a process (PIN) is currently 

running a program file (FID) . 

indicates that a process (PIN) has LOADPROCed 

a procedure (1<=EXT<=225) . 



program mode bit=0 (normal) everything that should be in priv is 

in priv mode and likewise for non- 
si (NOPRIV) everything in non-priv mode. 
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'*♦$♦ 



LOADER CACHE 



SYGLOB extension area + %72 contains DST number of cache 
BUCKETSIZE = %52 



k+ BUCKETSIZE 



IH-9V* BUCKETSIZE 
l*+95* BUCKETSIZE -1 | 



CACHE DATA SEGMENT FORMAT 


o| 

11 


HIT COUNTER | 


2| 
31 


MISS COUNTER | 


U| 


BUCKET | 


| BUCKET1 | 


• 


1 1 

| BUCKET 9k | 

1 1 



BUCKET FORMAT 



| Length 
| SLDIRl 


of | 
+1 | 


| SLDIR 1 | 


1 LENGTH ( 
| SLDIR2 ■ 


DF | 

•■ 1 1 



SLDIR 2 



Most recently referenced system SL 
directory entry from this SL directory 
bucket 



| Second most recently referenced entry 



| LENGTH OF 
I SLDIRN + 1 



I 



BUCKET | SLDIRN 
SIZE-lj 



i Nth most recently referenced entry; if 

| not complete then indicates end of 

bucket 
All bucket words are initalized to BUCKETSIZE +1, indicating 
no entries. 
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LOADER COMMUNICATION TABLE (LCT) SYSDB + %220 



Form incoming to Loader 




1 
2 
3 
k 

5 
6 

7 
8 

9 

10 
11 
12 
13 
1U 

15 
16 

17 
18 

19 
20 
21 



0| H 2| 31 U| 51 6| 71 8| 9U0|ll|12|13|lU|15 

i 



CMD 



I"! 



LIB | M| | L 
LOGICAL DEVICE # 



| PROG PIN 
DISC 



I--I-I 



ADDRESS 
# CHARS IN NAME 

PROCEDURE 

NAME 



WAITER PCB INDEX 



iBAjIAjPM! 



!MRJ IDSJPH 



GROUP 



NAME 



ACCOUNT 



NAME 



PVINFO (see "DIRECTORY ENTRIES") 



COMMAND 
PROGRAM FILE 
DESCRIPTOR 

CMD= loader cmd 
0=load prgm 
l=load proc 
2=alloc prog 
3=alloc proc 

LIB=library 
search 
0=SYS 
1=PUB 
2=GROUP 



M=NONPRIV MODE 
L=LOAD MAP REQ. 

USER CAPABILITY 
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LCT (CONT.) 



Form returned to WAITER 





1 
2 

3 
U 

5 



F.S. ERROR OR STARTING CST # 
LOAD PROCESS ERROR NUMBER 



LOAD MAP FLAG 



| LDEV 
I 



DISC 



ADDRESS 



TRUE IF LMAP 
PROVIDED 

\ 

I 

| LOAD MAP DISC 

I FILE DISCRIPTOR 

I 

/ 
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CHAPTER 12 PRIVATE VOLUMES / SERIAL DISC 



MVTAB (Mounted Volume Table) 



iiiii 



1 1:2:3 1 U:5:6 1 7:8:9 1 0:1:213:^: 5 



0| entry size : max entries 
I 

1| # of mounted volume sets 
I— - 

2| 

I" 
31 

I- 
k\ 



171 

I 

181 



19! 



201 



ldev 



DIRBASE 



of SYSTEM volume set 












1 

2 master volume of 
SYS VS is always 

3 ldev = 1. 

k 
5 



21 



| 22 
j 

J23 



I 21* 



■ entry 
(MVTABX = 0) 
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MVTAB (CONT.) 



19 
20 



0: cycl: 1 1 1 1 1 1 1 1 II 1 1 1 1 1 1 IN 1 1 1 1 1 



hvol:nvol: 



ucnt 



ldev : DIRBASE 
of volume set 



generation number 



ldev 



VTABX 



///////////////: 



vent 



ldev 



VTABX 



///////////////: 



vent 



2 master volume 
of volume set 

3 is on this ldev 

k 

5 I 

| - vol entry 

6 I (double) 



23 I 

|- vol entry 7 
2k I (double) 



-- entry 1 
(MVTABX = 1) 



• entry n-1 
(MVTABX = n-1) 
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MVTAB (COMT.) 



- ! * - *,«^-« 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1\ n 
ujuieyci.:// I i 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 i " 



I — - 

l|hvol:nvol: 

I 

2| 
I- 
31 



ucnt 



ldev : DIRBASE 
of volume set 



U| generation number 

I — " — 

5| ldev : VTABX 

I 



6|///////////////: 
I " 

I 

I 



vent 



191 



ldev 



VTABX 



I 



20|///////////////: 
I 



vent 



1 
2 

3 
U 

5 I 

| - vol entry 

6 | (double) 



23 

2k 



| - vol entry 7 
j (double) 



• entry n 
(MVTABX = n) 



cycl - cyclical volume index 
(local VTABX) for disc 
space allocation 

hvol - highest (ordinal) volume 

index (volume index being the 
volume set's local VTABX) of a 
mounted member of the volume 
set (class) . 

nvol - # of volumes mounted for the 
volume set ( class ) . 

ucnt - # of users having mounted 
the volume set. 

vent - # of users having mounted 
the volume. 
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PVUSER (Private Volume User Table) 

111111 
0|1:2:3|U:5:6|7:8:9|0:1:2|3:U:5 




1 
2 
$3 
U 



table size (words) 
///////////////: # of entries 



bitmask of MVTABX 's represented 
maximum table size ( words ) 



available pointer 
op mask : MVTABX 



max users : # pins 
current size of entry 



PV flags 
vmask 



| OP 



pin 



user bind count 
user mount count 



system bind count 
system mount count 



bind names count 
DST # of bind names segment 



vmask 


; 


pin 


user 


bind 


count 


user mount 


count 


system bind 


count 


system mount count 


bind 


names 


count 



DST # of bind names segment 




1 
2 
3 
k 



I 
PVUSER (CONT.) 



entry head 
(U words) 



- user entry 1 



user entry 2 



table head 
(5 words) 



volume set 
entry 1 
(MVTABX = j) 
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vmask 


• 


pin 


user 


bind 


count 


user mount 


count 


system 


bind 


count 


system 


mount count 


bind 


names 


count 



DST # of bind names segment 



- user entry n 



op mask 



MVTABX 



— — volume set 
entry n 
(MVTABX = k) 



a 
v 
a 

i 
1 
a 
b 

1 

e 
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Bind Names Data Segment 
(Created and managed via PVUSER Table) 



111111 
0| 1: 2:3| U: 5:6| 7:8:91 0:1: 2| 3 :U: 5 



max segment length 



current segment length 





1 
2 



-- entry 



bind count 



GROUP 
NAME 



ACCOUNT 
NAME 



10 





1 
2 
3 
k 

5 

6 

7 

10 



entry 1 
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BIND NAMES DATA SEGMENT (CONT.) 



bind count j \ 


i 1 ! 

| JL f 

GROUP -I I 

I 2 | 
NAME -| I 

I 3 ! 

I u I 


I 5 ! 

ACCOUNT -| ! 

I 6 | 
NAME -I I 

I 7 I 

|10 I 

a I 
v I 
a I 



1 

1 

a 
b 

1 

e 



-- entry n 
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Serial Disc Tables and Data Structures 



Data Record format 



The primary purpose of the Serial Disc Interface (SDISC) is to adapt the 
undefined length transfers characteristic of mag tape to the fixed length en- 
vironment of a disc or integrated cartridge tape (ICT). To accomplish this, 
data is buffered within SDISC. The buffer is an integral number of sectors 
(blocks for the ICT) long. Files always start on a sector boundary, but data 
records within files may start anywhere and straddle sector boundaries. A 
record in the buffer is structured as follows: 



| record | 




| record | 


1 length | 


data 


| length | 


1 (bytes) | 




1 (bytes) | 



The record length is always a one -word positive byte count which includes only 
the data portion of the record, not the length words themselves. Records with- 
in a file might be stored on the disc as follows: 



I RL I IIUIIIIIIIIIIIIIIIIIIIUII I 

i /////////// 1 rl i rl i mum 1 1 1 

I IIHIIIIIIIIIIIilll I RL I RL I //I 

i umuiimiimummimm i 

| ///| RL | RL i ////////////////// i 

I II I IUH III I RL I RL 1 1 mi I II 1 1 1 
I ////////////////////// I RL I RL I 

I IIIIIIIIIIIIIIIIIIIIIIIIUIIIIII I 

+ + + + + . 

I/////I RL I RL I | 

+ + + + + 



I 
Sector N-l 

I 

I 
v 



I 
Sector N 



The reason for the trailing byte count is to implement an easy way to back- 
space records. 
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End of File format 

Since files always start on a sector boundary, it follows that they also end 
on one. End of files consist of a record length and 0-fill to the end of 
the current sector as follows: 

+ - - + 

|//////////////////////// RL RL /! 
I //////////////////////////////// I 
MliUUl RL RL /////////////////I Sector N 

I + + 

I /////////////// I RL I o I 
+ - -+ I 

i ! 

I Zero fill I 

+ +— 

In addition, an End-of-File entry is made in the Gap Table, so that files may 
be skipped by scanning Gap Table entries instead of serially scanning the data 
area. The Gap Table is described a few pages from now. 
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Contiguous Block format 

A serial disc, if it can do everything a mag tape can do, must also be a 
cold-load device. This means that machine microcode must be able to read a 
bootstrap channel program and the resident segments of INITIAL from the disc 
into memory. The microcode and channel programs cannot deal with the record 
length words which surround standard data records, so for them we have a 
structure, called a CONTIGUOUS BLOCK, which has the data without the length 
words. Information as to the length of each contiguous block must therefore 
be kept elsewhere, so there are Gap Table entries which hold the beginning and 
ending sector addresses of each contiguous block. This implies that each block 
must begin and end on a sector boundary. In this way they are similar to data 
files. To set contiguous blocks off from normal data, and to reach a sector 
boundary, a record length and fill character = %177777 is used, as follows: 



+ + 

/////// Previous records ////// 
/////////////////////////////// 

////////I RL | -1 

+ 



+ 



+ 



-1 fill 



+ 



+ __ 



Contiguous block 



+ — 

I 
+ 

-1 fill 



I 
Sector N-l 

I 



Sector N 
v 



Sector N+l 

I 
v 



Hole format 

Holes on the serial disc have the same format as contiguous blocks (that is, 
they start and end on sector boundaries with -1 fill characters as required). 
They are generated during write error processing on the HP7920 or HP7925 large 
discs, or the HP7902 or HP9895 floppy discs. They are at least one track long. 
Write errors rarely occur in actual use, so holes are similarly rare. Further 
details may be found in the Serial Disc IMS. 
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Gap Table format 

The Gap Table is a four-word header followed by a series of two-word device 
address entries. A permanent copy lives on the device, starting in sector U, 
while a working copy lives in main memory. The copy in memory is posted to 
the disc only when a backspace or rewind operation occurs after writing (in 
other words, when the copy in main memory has changed). The length of the Gap 
Table is device -dependent according to the table below: 



Device 



Number of sectors (or ICT blocks) 



HP7920 


1* 


HP7925 


106 


HP7935 


219 


HP7902/9895 


26 


ICT 


U blocks ("S" cartridge) 




5 blocks ("L" cartridge) 



The Gap Table looks like this: 

I sector addr of load point |\ 

1 I unused | \ 

2 j unused | /-Gap Table header 

3 I unused 1/ 
+ + + 

U I type I I 

+ + Sector address | Entry (two words) 

5 I I 

+ + + 

6 I type I I 

+ + Sector address | Entry (two words) 

7 i I 
+ + 



The type field is bits 0, 1 and 2 of the first word. 
are: 



The eight possible types 



0. End of File. The associated sector address contains one or more end of 
file fill characters (0) to fill out that sector. In the worst case (the 
previous record ended exactly at the end of the previous sector) , the end 
of file sector contains all zeros. 

1. End of data. The associated sector address is the last address of valid 
data plus 1, in other words, the next available address. In practice, 
such an entry is usually preceded by an end-of-file entry, since the EOD 
entry is written when you stop writing, and the file system will not let 
you backspace or rewind after writing without sending a Write End of File. 
An EOD entry is also written at the beginning of the Gap Table when new 
(unwritten) media is inserted. This prevents erroneous reading of blank 
media. 
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2. Beginning of Hole. The starting address of a "defective" area of the disc. 
Usually on a track boundary, but may be in mid-track if a contiguous block 
was being written when the "defect" was encountered. 

3. End of Hole. The corresponding ending address of the "defective" area. 
Always at a track boundary. 

U. Beginning of (contiguous) Block. The starting address of a contiguous 
block, exclusive of the -1 fill characters which may have been required to 
get us to a sector boundary. Unlike the End of File fill characters, 
there need not be any -1 characters if the previous record or contiguous 
block (with or without the trailing length word) ended exactly on a sector 
boundary . 

5. End of (contiguous) Block. The address of the last sector containing con- 
tiguous block data. The sector may also contain -1 fill characters to get 
us to a sector boundary, but as with the beginning of block they are not 
required if the contiguous block ends exactly on a sector boundary. 

6. End of Tape mark. The sector address of the simulated End of Tape reflec- 
tor. This type is now written only to floppy discs for use by INITIAL'S 
serial disc interface. When read by MPE's SDISC, it will be skipped 

no matter what device it is found on. This ensures compatibility with 
older serial discs. 

7. End of Gap Table. No associated sector address. If you hit this while 
scanning the Gap Table, you've gone too far. In practice, this type is 
created whenever the Gap Table is cleared, by the simple device of ini- 
tializing the table to -1. 
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SDISC Extra Data Segment 

With insignificant exceptions, SDISC operates entirely in split-stack mode, 
that is, using an extra data segment for its working storage. Since SDISCIC 
runs on the user's stack (under the File System and ATTACHIO) , it reallj 
wouldn't do to have the user support a l6K RECBUFF (for an ICT) or a 13. 6K Gaj 
Table (for a 7925) on his stack. 

The extra data segment (XDS) is usually acquired by the external procedur« 
ALLOCATE when the serial disc device is first assigned to a user as part of ax 
FOPEN. The external procedure DEALLOCATE makes the XDS go away as part of its 
processing of the final FCLOSE against the device. The system program PVPROC 
may also acquire and release an XDS so that the tape label routines in LABSE( 
may also use SDISC for their work when DEVREC processes a device on-line in- 
terrupt. 

In addition to the Gap Table already described, the XDS contains a data buf- 
fer (RECBUFF), SDISC 's global storage area and a small buffer (called WORKTA- 
BLE) used to hold data while moving it from a "defective" disc area to its nei 
location as part of the process of creating a hole. WORKTABLE also holds th< 
contents of the Serial Disc label sector when SDISC reads it in as part of it! 
self -configuration. 

The three arrays in the XDS (WORKTABLE, RECBUFF and GPT (Gap Table)) are ali 
dynamically configured by SDISC as vanilla indirect arrays, such as might havi 
been constructed by SPL. This is done by declaring the array names as poin 
ters, then inserting appropriately computed element- addresses in them. 

The extra data segment is organized as follows: 






WORDSPERSECTR | 


1 


SECTORSPERTRAK 1 


2 


STARTADDRESS (BOT) | 


3 
U 


EOTSECTR (disc ] 
address of simu- | 
lated end of tape) | 


5 
6 


EODSECTR (last | 
sector of disc) | 


7 


JUSTALLOCATED j 


8 


WRITERING 1 


9 


FATALERROR j 


10 


LPERRORLOG | 



These twelve words are reserved 
for use by ALLOCATE when the data 
segment is created. However, AL- 
LOCATE only stuffs the last five 
of them. We fill the first seven 
ourselves with information we get 
from the label sector. 



Simulates tape runoff. 



Tells us to initialize SDISC 
parameters to BOT if true. 
Simulation of tape write ring. 

Disables SDISC when true. 

Dumps XDS and user stack to LP 
if true and FATALERROR occurs. 
Currently may be set only in 
DEBUG. 
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11 



MAX 'DSEG' SIZE 



SDISC global vari- 
ables , including 
array pointers. 



W 



K 



B 



E 



E 



B 



U 



T 



B 



Max size of our XDS, so we can 
check that it's big enough. 



Length is WORDSPERSECTR . 



Length is calculated as 32 * 
WORDSPERSECTR. 



Length varies with device, and is 
calculated by SDISC as part of its 
self -configuration. 
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Serial disc organization 

The disc is organized as follows: 



Label sector 



— + 

I 
+--- + 

I Defective Trk Tbl | 
+ + 

Cold load | 

+ 

Soft dump | 

+ 

Gap Table I 



I 

-+ 

I 



Data 



! 

Last data sector | 

+ 



See expanded view in Chapter 3. 

1 Maintained by disc driver, not 

used by SDISC. 

2 HP- IB cold load channel prog. 

3 SOFTDUHP channel program. 
k to STARTADDRESS - 1. 

STARTADDRESS 

to 
EOTSECTR 

to 
EODSECTR 
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CHAPTER 13 I/O 



IOQ* 
1 >j FLAGS | 



I IOQP | 
| |LDEV | 
! ! 



I 

| DLT 

I 

I 



•>/ LOGICAL \ I/O TABLE LINKAGE 
\ DEVICE / 



I 



DITP 
FLAGS 



FLAGS 
DITP 



IOQP* 
UNITlLDEV 



DLTP 
ILTP 



LPDT 



DIT 



ILT 



Ch| |DRT | 

SIOP | 

UNIT EXTRACT 



SIOP | Q # | 
SIZE I 



I 



+UNIT 



DITP 






DRT 
SIOP 



PI 
ILTP 
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* DRQ for disc requests 



DEVICE REFERENCE TABLE (DRT) 



(SERIES II/III) 



SIOP 



PI 

DBI 

RESERVED 



SIOP - absolute address of SIO program 

PI - interrupt handler plabel 

DBI - this is the absolute address of the ILT 



ABS 
8 



(/33, AU) 
Bank of DRT 



9 j Offset of DRT in Bank | 



DRT ENTRY ON /33, A 1 * 
SIOP 



DBI 

PI 

Channel Flags 
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DRIVER LINKAGE TABLE (DLT) 

l 2 3 U 5 6 7 8 9 10 11 12 13 l 1 * 15 



QUEUE NUMBER 



j Ltf j nv/ 1 VTl | 

j (SEE BELOW) 



JO jMTYP | 



li 

i 

2| 

i 

31 
I 



MONITOR PLABEL 



INITIATOR PLABEL 
C0MPLET0R PLABEL 



h\ INTERRUPT PLABEL 

I — 

5 1 DIT SIZE | DEVICE TYPE 
| 

61 
I- 

71 



CS DRIVER EDITOR PLABEL 
INITIALIZATION PLABEL 



DPROC 
DMNTR 
DINIT 
DCOMP 
DINTP 
DTYPE 



There is one DLT for each type of driver. A pointer in the DIT allows 
different devices on a controller to have different drivers and 
interrupt handlers. 



DPROC. QNUMB 

.(8:1).DRVRFRZN - 
(DF) 

.(9:1).MAMERR0RC- 

(MC) 
.(10:1).CORERES - 

(CR) 
.(lU:2).DRVRTYPE- 

(MTVP) 



This field contains the I/O process request queue 
number for type 2 drivers. Zero for all other types. 
Driver code frozen. Set by MAM when then the driver 
code segment has been made present and frozen from a 
request from SIODM. 
MAM Error on Code Makepresent 

If set both initiator and completer code are core 

resident. 

DRIVER/MONITOR TYPE 

- not used 

1 - driver can be executed on any stack 

2 - driver can be executed in the user process or 

in the I/O process identified by IDNUMB 

3 - run only in process whose PCB number is in 

IDNUMB 



DMNTR - I/O Monitor Plabel. 

DINIT - Driver Initiator Procedure Plabel. 

DCOMP - Driver Completor Procedure Plabel. 

DINTP - Special interrupt hanler Plabel. This procedure is called 
by GIP if ISPEC is set DFLAG. No other action is taken by 
GIP except to set the Interupt Status in DSTAT. 

DTYPE. DITSIZE - The length of the DIT in words for this driver. 
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LOGICAL-PHYSICAL DEVICE TABLE (LPDT) 



The system uses the Logical-Physical Device Table (LPDT) for many 
purposes. For every physical device on the system, there is an 
entry which is used to communicate to the system the various 
states the device may be in. Included in the entry is the 
DRSTATE (device recognition state) used by DEVREC and the I/O 
drivers for the handling of unexpected interrupts (e.g., a tape 
mount, a carriage return on an available terminal). Also in the 
LPDT is an entry for every open spoolfile, which allows a large 
part of the operating system to treat open spoolf iles in much 
the same way as physical devices are treated. 

Much of the low- level operating system software accesses the 
LPDT. Specifically, DEVREC (the device recognition system 
process) and many I/O drivers modify both the LPDT header and 
the DRSTATE for specific devices. Although there is an LPDT SIR, 
these low-level modules don't use it: we do not wish an I/O 
driver to impede while waiting for a SIR. Thus, whenever either 
the LPDT header or the second word of an LPDT entry are modified, 
the modifying software first DISABLES in order to lock the LPDT. 
Software that accesses the spooling information in the LPDT 
typically uses the SIR mechanism to lock the table. 

Although it would seem that SIR locking is the proper method for 
locking the LPDT, not all software that modifies the LPDT uses 
it. As a result, improper LPDT locking could lead to incorrect 
information in the LPDT header. Included in the header is the 
service request count for DEVREC. Occasionally, this count is 
decremented once too often; thus, the highest numbered logical 
real device requesting DEVREC service will never get serviced. 

In summary, if you are modifying the LPDT for a real device, you 
must first DISABLE, do all your modifications, and then ENABLE. 
This is also the case if you want to be sure of the LPDT data you 
are reading. 

If you are modifying the LPDT for a virtual device (an open 
spoolfile), you must lock the LPDT SIR before the table can 
be safely modified. 

It is easy to determine that the LPDT was improperly locked after 
the fact, but it is impossible to determine who was improperly 
locking the table. To avoid improper LPDT 
locking, it is imperative that you eye-check all code for 
improper locking. 
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^x 



HIGH ENTRY f 



__| 

ENTRY SIZE | 



LPDTDST=%15 
LFDTSIR=%11 



SERV. REQ INT 



1 0| 



same -- 



HI 
Ulol 



XDD INDEX 



— same 



— same 



NORMAL DEVICE ENTRY 



I 
/ 



VIRTUAL DEVICE ENTRY -ASSIGNED 
10 = IDD 
= 1 ODD 



VIRTUAL DEVICE FREE ENTRY 
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LPDT (CONT.) 

LPDT ENTRY 
1 2 3 U 5 6 7 8 9 10 11 12 13 Ut 15 



I I I CT| | | | BR | LG | 

I | | — |DUP|INTR| I--I--I 

DRSTATE | JOBS | DATA | BOT | | | EOF j |DR| SUBTYPE 

I I | — | — I— "I I--I-I 

I I INSDJ M | RV | |SF|FS| 



There is one two-word entry in the LPDT for each Logical Device. 

The base of the entry for a given Logical Device is equal to the 
Logical Device number multiplied by the entry size (word 0.(8:8)), 
currently two. The physical device characteristics are maintained in the 
DIT and ILT. 

The field definitions for each entry are: 

WORD -- 

VFLAG - Virtual device flag 

DITP - When VFLAG = 0, SYSDB relative pointer to the DIT 

1, Virtual device information 

WORD 1 -- 

The following fields are defined for all devices: 

DRSTATE - Device Recognition State 

0-Not owned 

1-Owned or recognized 

2-Service requested - set by driver upon unexpected 

interrupt and awake DEVREC 

3 -Service granted - set by DEVREC 
(sequence for logon: 0-2-3-1) 
JOBS - Accepting Jobs or Sessions 
DATA - Accepting Data 
EOF - End of File condition 

0-No EOF 

1 -HARDWARE EOF 

2-: DATA 

3-:EOD 

It-: HELLO 

5-: BYE 

6-: JOB 

7~:E0J 
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LPDT (CONT.) 

SUBTYPE - Device subtype. For tapes, the SUBTYPE is divided into two 
subfields as follows: 

W0RD1.(13:3) - actual device subtype 
W0RD1.(12:1) - = operator allocation 
1 = automatic allocation 



The definitions for bits U,5,6,10, and 11 in word 1 are device dependent. 

For terminal-like devices only, 

CY - Control Y is allowed and has been detected 

BR - Break detected or ignore break if main running 

LG - The terminal is logging on. This bit is set by PROGEN 

and DEVREC when the logon sequence starts. If the bit is 
off when polled by INITJSMP, the terminal has disconnected. 
For now, only IOTERMO and HIOTERMO support the use of this 
bit. MULTIPOINT and DS pseudo-terminals do not. 

For tape drives only, 

BOT - Tape is at load point or no tape mounted 

DR - DEVREC is performing Automatic Volume Recognition (AVR) on 
tape drive or suppress AVR on job/data-accepting tapes 

For all devices except disc drives, 
DUP - Duplicative 
INTR - Interactive 

For disc drives only, 

NSD - The disc is a non-system domain disc drive 

For non-system domain disc drives (NSD=1) only, 
M - Mounted private volume 
RV - Reserved volume for multiple pack mount requirement 

SF - Serial or foreign disc physically and logically mounted 4 

FS - If SF = 1, then: FS = 0, Serial disc 

FS = 1, Foreign disc 
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LPDT (CONT.) 



I — " 

| | V=0 then DITPOINTER 
OJ VJ V=l then Virtual Device Entry Info. 



--as before -- 



The first word of each entry in the LPDT has changed to reflect 
the addition of Virtual Devices. 

A "real" logical device (ie. one on which an ATTACHIO call may be per- 
formed) has the sign bit set to "zero". 

A "virtual" logical device has the sign bit set to "one". Thus any- 
one who loads the DIT pointer for use must check this sign bit. 



OVERVIEW OF DEVICE TABLES IN DST %l6 



1< DST %16 



LOGICAL DEVICE TABLE 
LDT 



DEVICE CLASS TABLE 



LOGICAL DEVICE TABLE 
EXTENSION 
LDTX 
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DST 16(8) = 1U(10) 
SIR X£<oj - iuviu; 



LOGICAL DEVICE TABLE 
(Indexed by Log Dev#) 

ZERO ENTRY FORMAT 



1 2 3 ** 5 6 7 8 9 10 11 12 13 I 1 * 15 

0j HIGHEST ENTRY # \ ENTRY SIZE=5 



j POINTER TO FIRST DEVICE CLASS ENTRY 
1| (RELATIVE TO TABLE BASE) 

I - 

2 | NUMBER OF DEVICE CLASS ENTRIES 

I 

3 j SIZE OF DEVICE CLASS TABLE 



UI///////////////////////I STREAMS DEVICE NUMBER | 
I I 

TYPICAL ENTRY FORMAT 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

FILE USE COUNT |0 



VOL TABLE INDEX IF DEV | I *or process # of 
TYPE<8 OTHERWISE * | CONTROL Y PIN |1 I/O spooler for 
MAIN PROCESS PIN # | I this device 
I 

RECORD WIDTH jCSiFOi DEVICE TYFE |2 



| | | | | | | DEFAULT OUTPUT DEVICE j 
SS | F| M| R| |HT| C| OR CLASS INDEX(C=1) |3 
- I 

IS | I 

MISC | Q| VDD INDEX |U 
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LDT (CONT.) 



SS. . . spool state 

not spooled reserved 

1 spooled input for 

2 spooled output spooling 
= 1 SPOOLING ENABLED 

. default device is class index CS 
. avail to system FO 

. avail to diagnostics HT 

. down requested 



SQ 
C . 
F . 
M . 

R . 

MISC 



CS device 
Special Forms 

= Header/Trailer on 

1 = Header/Trailer off 



1) 
2) 



. . miscellaneous information, device dependent: 

For terminal-like devices, default terminal type to be used when 
not specified in HELLO command. 

For variable density tape drives, contains density information. 
W0RDlt.(l:3) -- actual tape density 

= density not yet determined 

1 = 1600 BPI 

2 = 6250 BPI 

density requested in FOPEN for writes to tape, 
unlabelled tapes only 

= no FOPEN with write access yet 

1 = 1600 BPI 

2 = 6250 BPI 



W0RDU.(U:3) -■ 
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DEVICE CLASS TABLE 
(Sequentially Organized) 

TYPICAL ENTRY FORMAT 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

0| I 

1 ' ! 

1| 

j CLASS NAME 1 

21 



I— 

k\//\ CYCLICAL POINTER |SQ| T | CLASS ^CCESS^TY 

5|#0F DEVICES IN CLASS (N) | DEVICE #1 



T=TERMINAL 
ACCESS 
BIT 



N/2+; 





WhaI Ike ^.- t 



SQ = Spool Queue bit 



NOTE: The device class table is in the same data segment (DST 16(8) 
as the LDT. ie., the LDT consists of three separate tables. 

1. logical device table and 

2. device class table 

3. LDT Extension 
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Logical Device Table Extension (LDTX) 



DST %16 = #lU 
SIR %12 = #10 



Zero Entry 



1 2 3 ** 5 6 7 8 9 10 11 12 13 lU 15 



Highest Entry # | 



Entry Size 



Typical Entry 

1 2 3 U 5 6 7 8 9 10 11 12 13 1*» 15 
S|SD|CP|NS| reserved |DB| TBRC 
device specific 
information fields 
See the following examples 
LDTX descriptor 



+ 



— + 



Legend for all entries: 



S Seek ahead enable/disable flag (system or PV disc only). 

SD This logical device is a Serial Disc. 

CP This logical device uses the CIPER protocol. 

NS This is a non-shareable (system or PV) disc device. 

DB If set to 1, then debugging in effect (CIPER calls DEBUG) 

TBRC. . .Terminal's baud rate code. 
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Logical Device Table Extension (LDTX) 



Terminal Entry 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
+ — + _ _+__+__+ — + — +--+ — +__+__+ — + — + — + — + — +--+ 



0| 0| 0| 0| reserved 1 



TBRC 



TB| 



reserved for ATP 



TB used only on Series 3X, UX, 6X 

1 - terminal connected to ATP 
= terminal connected to ADCC 

TBRC. . .Terminal's baud rate code. 



Series III (ATC) 
TBRC chars/second 



Series 3X, UX, 6X (ATP or ADCC) 
TBRC chars/second 



1 


2U0 


2 


120 


3 


60 


u 


30 


5 


15 


6 


10 


7 


Ik 



1* 


6 


60 


%1 


7 


2U0 


5&io 


8 


960 


%n 





U80 


%12 


10 


unused 


%13 


11 


120 


%lU 


12 


unused 


*L5 


13 


30 


%16 


1U 


15 


JUT 


15 


10 


foZO 


16 


1920 


%21 


17 


38U0 


TtHX. 


10 


xou 
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Serial Disc Entry 

1 2 3 *» 5 6 7 8 9 10 11 12 13 1U 15 
+--+ — + — + — + — +--+ — +--+--+--+ — + — + — + — + — + — + 

| 1| 0| 0| reserved | | 



Serial disc extra data segment # 
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Logical Device Table Extension (LDTX) 



CIPER Entry 



1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 
+-_+_-+ — + — + — +_-+--+ — +__+-_+ — + — +__+__+ — + — + 

0| 0| 1| 0| reserved |DB| 



CIPER Device Control Data Segment # (CDCDS) 



DN| CTM Index for this device (CTMI) 



DB If set to 1, then debugging in effect 

DN If 1, the CIPER facility has been de-activated for this device 

because of error, 
CTMI ... Control Table Map Index (an index into the Control 

Table Map (CTM) which is located in the CIPER Data Segment (CDCDS) 





System or Private Vol. Disc Entry 





1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
S| 0| 0| 1| reserved | | | 


1 


! 


2 


Disc Free Space DST number (DFSDST) | 


3 


Disc Free Space error status (DFSERR) | 




n I 



S Seek ahead enable/disable flag. 
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INTERRUPT LINKAGE TABLE (ILT) 

ILT FOR SERIES II/III 

l 2 3 h 5 6 7 8 9 10 11 12 13 lU 15 
+ — + — + — + — + — +--+--+--+--+--+ — + — +--+ — +--+ — + 

I I ICPVAO 

+ + 

1 I | ICPVAOl 

+ + 

2 | | ICPVA02 

+ + 

3 1 | ICPVA03 
+ + 

U | I ICPVAOU 

+ + 

5 1 | ICPVA05 
+ + 

6 I | ISRQL/ICPGM 

+ + 

7 I M| CHANQUE | | DRT NUMBER | IDRTN 
+ + 

%10 |SYSDB relative pointer to I/O program area. | ISIOP 

+ + 

%11 | | ISTAP 

+ + 

%12 | single instruction that is executed to extract | IUNIT 

| the device unit number from the status. | 

+ + 

%13 I | ICDP 

+ + 

%lU | SIOPSIZE | CQUEN | IQUEUE 
+ + 

JtL5 I I I I I | IFLAG 

+ + 

%16 | SYSDB relative DIT pointer for unit | IDITPO 
+ + 

+ + 

| SYSDB relative DIT pointer for unit n | IDITPN 

+ + 

I Seekmask (Disc only) j 

+ + 

I I/O I 

| Program I 

| Area I 

+ + 

SIOPSIZE - SIO PROGRAM SIZE / 2. 
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ILT FOR SERIES 30/33AU k SERIES II/III (HP-IB) 

1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 
+--+--+--+--+--+--+--+ — + — +--+--+--+ — +--+ — + — + 

| Channel I ICPVAO 

1 J Program I ICPVA01 

2 I Variable I ICPVA02 

3 J Area (ICPVA) | ICPVA03 
+ + 

1» | DMA Abort I ICPVAOU 

5 J Address I ICPVA05 

+ + 

6| I ISRQL/ICPGM 

+ + 

7 | H| CHANQUE | | CHAN | DEV | ICNTRL 
+ + 

%10 |SYSDB relative pointer to channel program area. | ISIOP 
+ + 

%11 |SYSDB relative pointer to status return area. \ ISTAP 

%12 | single instruction that is executed to extract | IUNIT 

| the device unit number from the status pointed | 

| to by ISTAP. I 

+ + 

%13 JSYSDB relative DIT pointer of the device j ICDP 
[currently using the channel to perform a data \ 
| operation. I 

+ - + 

%lU | SIOPSIZE | CQUEN | IQUETJE 
+ + 

%15 |RW|WP|IG|SC|SQ| | HCUNIT | IFLAG 
+ + 

%l6 | SYSDB relative DIT pointer for unit | IDITPO 
+ + 

+ + 

| SYSDB relative DIT pointer for unit n | IDITPN 

j. j. 

| Program status return area | 

j pointed to by ISTAP | 

+ + 

! Seekmask (Disc only) | 

+ + 

I I/O I 

| Program I 

| Area I 

+ + 
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ILT TERMINOLOGY 

IPCVA - These four words comprise the channel program 

variable area where information is stored concerning 
a channel program Interrupt instruction or abort. 
CPVAO should be used only for channel program aborts. 
ICPVAU - Words k and 5 contain DMA address, when channel program 

aborts during DMA transfer. 
ISRQL - Serial poll request queue length. Series 33 currently 
does not support any serial poll devices. This should 
always be zero. 
ICPGM - This is the SYSDB relative address of the channel program 
to be started for this device after receiving a HIOP 
interrupt in GIP. GIP will call STARTIO when the flags 
word indicates "ignore halt interrupt" and "start channel 
program" bits are set. 
ICNTRL - Contains controller information. 

.M If set, the controller is sharing a software channel 
resource in order to limit bandwidth. 
.CHNQ The software channel resource number. 
.DRTN The DRT number for a Series 33 device is equivalent to: 

.CHAN - channel number (U most significant bits of DRTN) 
.DEV - device number (3 least significant bits of DRTN) 
IFLAG - Used for controller flags. 

.RW Runwait flag. An idle channel program should be started 

when there are no active requests to process. 
.WP Waitprog flag. An idle channel program has been started 
for this controller. This bit is reset by an interrupt. 
. IG Ignorehi flag. An HIOP instruction has been issued against 
this controller, but the channel program was not in a 
wait statement. Therefore, ignore the interrupt generated 
by the channel code when this program halts. 
.SC Start channel program flag. When set along with the IG 
flag, GIP will start a previously attempted SIOP on this 
device. 
.SQ Start channel program "queued" flag. When bit SC is set, 
this bit will determine if the call to START'HPIB will 
have logical parameter QUEUED true or false. 
.HCUNIT Highest configured unit number for this controller. 
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DEVICE INFORMATION TABLE (DIT) 



There is one DIT per physical device. If a physical device represents 

represents more than one logical device, the logical device 

number is obtained from the I/O queue element. 

Although details of DIT's vary with device, the following 

structure is common to all: 

DIT for Series II/III 

1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

|T |D |AC|RQ|CE|MU|SP|IO|IA|NO|ST|NS| STATE | DFLAG 

1 |SYSDB relative pointer to the DIT for the next | DLINK 
I device requesting this resource or service | 

+ ----- — + 

2 |SYSDB relative pointer to the first IOQ in I DIOQP 
I request list for this device I 

+ + 

3 | IOT | Phys. unit # | Logical device number | DLDEV 
+ + 

k jSYSBB relative pointer to Driver Linkage Table | DDLTP 
+-- — + 

5 ISYSDB relative pntr to Interrupt Linkage Table | DILTP 
+ + 

6 | Controller hardware status I DSTAT 
+ - — + 

7 ! Hardware error status. Set when the driver 1 DSERR 
j detects an error. Whenever <>0, the driver | 

| monitor logs an I/O error and clears this word| 

+ - "+ 

| Device Dependent Area I (DTIME) 

+ + 
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DIT TERMINOLOGY (SERIES II/III) 



DFLAG - DEVICE RELATIVE FLAGS 
T SET IF DEVICE IS A TERMINAL. 
D SET IF DEVICE IS A DISC. 
AC ACTIVE BIT. 1 IMPLIES A MONITOR CURRENTLY SERVICING 

THIS DEVICE. 
RQ REQUEST BIT. 1 IMPLIES SERVICE REQUESTED WHILE 

MONITOR IS ACTIVE. 
MU IF SET, MULTIPLE UNIT CONTROLLER. 

10 IF SET, THEN A CHANNEL PROGRAM IS CURRENTLY EXECUTING. 
IA IF SET, AN INTERRUPT OR RESPONSE HAS OCCURRED. 
NO IF SET, DEVICE IS IN A NOT READY OR OPERATOR WAIT. 
CE CACHING ENABLED ON THIS DEVICE (MASS STORAGE ONLY) 
SP SIO PREEMPTION 
ST START WAIT CHANNEL PROGRAM 
NS DO NOT SHORT WAIT THIS DISC 
STATE CURRENT DRIVER STATE AS DEFINED BY THE MONITOR. 

ALLOWABLE STATES ARE: 

- START REQUEST 

1 - NOT USED (BUT RESERVED) 

2 - CALL DRIVER INITIATOR 

3 - CALL DRIVER COMPLETOR 

U - NOT USED (BUT RESERVED) 

5 - COMPLETE REQUEST 

6 - UNEXPECTED INTERRUPT OCCURED 

7 - START OPERATOR INTERVENTION WAIT 
%10 - WAITING (ON OPERATOR). RESTART AT 
%11 - WAITING (DATA MAKEPRESENT /FREE ZING) 

%12 - WAITING (INITIATOR CODE MAKEPRESENT/FREEZE) 
%13 - WAITING (FOR COMPLETION INTERRUPT) 
%lk - WAITING (FOR DEVICE CONTROLLER AVAILABILITY) 
%15 - NOT USED (BUT RESERVED) 
%16 - WAITING (INITIATOR CODE MAKEPRESENT) 
%17 - WAITING (COMPLETOR CODE MAKEPRESENT) 
IOT - I/O System type O-Series II/III I/O System 

1-HP-IB 

2 -unused 

3 -unused 
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DIT FOR SERIES 30/33AH 

1 2 3 k 5 6 7 8 9 10 ii 12 13 l 1 * 15 

!T |D |AC!RQ|CE|MU| 0!lO|IAjN0jST|NS| STATE I DFLAG 

1 |SYSDB relative pointer to the DIT for the next | DLINK 
j device requesting this resource or service | 

+ — - + 

2 |SYSDB relative pointer to the first IOQ in | DIOQP 
j request list for this device I 

+--- + 

3 | IOT | Phys. unit # | Logical device number | DLDEV 
+ + 

U ISYSDB relative pointer to Driver Linkage Table | DDLTP 
+ - + 

5 |SYSDB relative pntr to Interrupt Linkage Table | DILTP 
+--- + 

6 | Controller Hardware Status | DSTAT 
+ + 

7 | Hardware error status. Set when the driver \ DSERR 
j detects an error. Whenever <>0, the driver I 

| monitor logs an I/O error and clears this word| 

+ + 

| Device Dependent Area I (DTRQX) 

+ __—— + 

DTRQX Used by some device drivers, it denotes timer 
request index. 
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DIT TERMINOLOGY (SERIES 30/33) 



DFLAG - DEVICE RELATIVE FLAGS 
T SET IF DEVICE IS A TERMINAL. 
D SET IF DEVICE IS A DISC. 
AC ACTIVE BIT. 1 IMPLIES A MONITOR CURRENTLY SERVICING 

THIS DEVICE. 
RQ REQUEST BIT. 1 IMPLIES SERVICE REQUESTED WHILE 

MONITOR IS ACTIVE. 
MU IF SET, MULTIPLE UNIT CONTROLLER. 

10 IF SET, THEN A CHANNEL PROGRAM IS CURRENTLY EXECUTING. 
IA IF SET, AN INTERRUPT OR RESPONSE HAS OCCURRED. 
NO IF SET, DEVICE IS IN A NOT READY OR OPERATOR WAIT. 
ST IF SET, AN IDLE CHANNEL PROGRAM SHOULD BE STARTED FOR 

THIS DEVICE. 
CE CACHING ENABLED ON THIS DEVICE (MASS STORAGE ONLY) 
NS DO NOT SHORT WAIT THIS DISC 
STATE CURRENT DRIVER STATE AS DEFINED BY THE MONITOR. 

ALLOWABLE STATES ARE: 

- START REQUEST 

1 - NOT USED (BUT RESERVED) 

2 - CALL DRIVER INITIATOR 

3 r CALL DRIVER COMPLETOR 

U - NOT USED (BUT RESERVED) 

5 - COMPLETE REQUEST 

6 - UNEXPECTED INTERRUPT OCCURED 

7 - START OPERATOR INTERVENTION WAIT 
%10 - WAITING (ON OPERATOR) . RESTART AT 
%11 - WAITING (DATA MAKEPRESENT/FREEZING) 

%12 - WAITING (INITIATOR CODE MAKEPRESENT/FREEZE) 
%13 - WAITING (FOR COMPLETION INTERRUPT) 
%ll* - WAITING (FOR DEVICE CONTROLLER AVAILABILITY) 
%15 - NOT USED (BUT RESERVED) 
%16 - WAITING (INITIATOR CODE MAKEPRESENT) 
%17 - WAITING (COMPLETOR CODE MAKEPRESENT) 
IOT - I/O System type O-Series II/III I/O System 

1-HP-IB 

2 -unused 

3 -unused 
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DIT for SIO Devices 



6 



8 9 10 11 12 13 Ik 15 

_____„ == i 



TERM | DISC | ACT | REQ |CE | M | SIO | 10 |IAK| M | NT | | STATE 
I j | | |UNIT| PREMP|PROG| |HEAD|RY| | 



NEXT DITP 
I0QP 



IOT 



UNIT 



LDEVN 



DLTP 



ILTP 

Controller Hardware Status 

Hardware Error Status 



DRIVER DEPENDENT DIT AREA 



DFLAG 

DLINK 

DIOQF 

DLDEV 

DLTP 

DILTP 

DSTAT 

DSERR 

DTRQX 



DFLAG. TERMINAL - Device is a terminal 

.DISC - Device is a Disc (Bit 0=0) 

.ACTIVE - A monitor is currently servicing this device 

•REQUEST - Service requested while monitor was active 

.MUNIT - device controller servicing multiple units 
.SIOPREMPT- If set then a preemptive request has been queued for 

this device. Preempt code is set in IOQ. 
.IOPROG - I/O program in progress. Decrement SIOCOUNT and 

check for multi-channel when complete 
.IAK - Interrupt or Response has occurred. 
.M HEAD -Moving head disc 
.NT RDY -Not ready for SIO. SIODM holds off next SIO until 

ALLOWPOLL is done. 
.CE - Caching is enabled on this device (mass storage only) 

DTRQX - Used by some device drivers, it denotes timer 
request index. 



13-23 



DIT FOR SIO DEVICES (CONT. ) 

DFLAG. STATE - this quantity specifies the next action to be taken 
in servicing the request. 

0-new - start request. 

1-not used. 

2-call Driver Initiator Procedure 

3-call Driver Completor Procedure 

5-complete request 

6-device recognition 

7-start operator intervention wait (%10) 
JfcLO-restart request on interrupt 
%11-wait for data to be frozen then state 2 
%12-wait for driver code to be frozen then state 2 
#13 -call completor on interrupt 
%1 it-wait for device controller 
%15-not used 

Jtl6-wait for initiator make present then state 2 
%17-wait for completor make present then state 3 



DLINK 
DIOQP 

DLDEV.LDEVN 
.UNIT 
.IOT 

DDLTP 

DILTP 

DSTAT 

DSERR 
DTIME 



SYSDB relative pointer to the DIT for the next device 

requesting this resource or service. 

SYSDB relative pointer to the first IOQ in the request 

list for this device 

Logical Device Number 

unit number of the physical device. 

10 type 0=> Series III I/O, 1=> HPIB I/O 

SYSDB relative pointer to the DLT. 

SYSDB relative pointer to the ILT. 

interrupt status for this device. Set each time the 

device interrupts. 

Hardware Device Controller Status. Set when the driver 

detects an error, whenever not zero SIODB logges an 

I/O error and clears this word. 

time out completed flags. If a timeout occurs in response 

to a timer request type %20 (I/O request), the sign bit 

is set in this word. The IA bit in DFLAG is also set, 

and the monitor for this device is awakened. (Only used 

if timer services are requested. Must be word #8 if timer 

services are requested.) 
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DIT FOR FIXED HEAD DISK 



9 



10 



11 



12 



1 2 3 *t 5 6 7 8 9 10 11 12 15 

II I I II I I I I I I 

0| 1|ACT|REQ|CE | 0| 0|I/0|IAK| | 0| 0| STATE 



NEXT DITP 
CURRENT REQUEST SYSBASE INDEX 



IOT 



I 



LDEVN 



DLTP 



ILTP 



DEVICE STATUS 



DEVICE STATUS (ERROR) 



SYSBASE INDEX OF FIRST REQUEST IN QUEUE 



SYSBASE INDEX OF LAST REQUEST IN QUEUE 



XFER COUNT 



LOGICAL DISK ADDR 



SYSBUF ADDRESS 



ERROR & RETRY INFORMATION 



I I 
B| W| 



RETRY 
COUNT 



DFLAG 

DLINK 

DCURRREQP 

DLDEV 

DDLTP 

DILTP 

DSERR 

DQHEAD 

DQTAIL 

DXFER 

DDADR 

DSYSBA 



QMISC 
OF IOQ 



IOT - I/O Devices 

- Series II/III 

1 - HP- IB 
3 - unused 
It - unused 

B - modify bad track table 
W - write bad track table 
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DIT FOR 7900A & 2888A MOVING HEAD DISC 

12 3^5 67 8 9 10 11 12 15 





0| 1|ACT|REQ|CE | M | 0| I/0|IAK| 1 | 0| 0| STATE 
I I I I IUHIT | IPROGI I | | | 


1 


NEXT DITP 


2 


CURRENT REQUEST SYSBASE INDEX 


3 


IOT | 




UNIT | LDEVN 


U| 


DLTP 


51 


ILTP 


61 


CURRENT DEVICE STATUS 


71 


DEVICE ERROR STATUS 


81 


SYSBASE 


INDEX 


OF FIRST REQUEST IN QUEUE 


91 


SYSBASE 


INDEX 


OF LAST REQUEST IN QUEUE 


10 1 
llj 


CURRENT DISC 
ADDRESS 


12 1 
131 


ALTERNATE TRACK 
DISC ADDRESS 


lit I 


CURRENT CYLINDER 


151 


CURRENT DATA BUFFER ADDRESS 


16 1 


NEXT DATA BUFFER ADDRESS 


171 


WORD COUNT REMAINING 


18| 


CURRENT WORD COUNT 


191 


SYSBUF ADDRESS 



DFLAG 

DLINK 

DCURRREQP 

DLDEV 

DDLTP 

DILTP 

DSTAT 

DSERR 

DQHEAD 

DQTAIL 

DADR 

DALTADR 

CURCYL 

DBUFF 

DNXTBUFF 

WCR 

CWC 

DSYSBA 



IOT - I/O Devices 

- Series II/III 

1 - HP-IB 
3 - unused 
U - unused 
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ERROR & RETRY INFORMATION 
1 2 3 1+ 5 6 7 8 9 10 11 12 13 lU 15 

■ i i i i i i i I I RETRY j 

| m| r| w| T| a! x| C| si oi COUNT I QMISC OF IOQ 

I--I--I--I-I--I-I--I--I -I 1 

M - handling defective "track snap A - reading alternate track 

R - read defective track map X - xfer from alt. track 

W - write defective track map C - recalibration done 

T - track to track xfer S - seek or recal in progress 
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DIT FOR 7905/7906/7920/7925 



1 
2 
3 
U 

5 
6 

7 
8 

9 

10 
11 

12 
13 

1U 

15 
16 
17 
18 

19 
20 
21 
22 
23 
2U 



1 2 3 U 5 67 8 9 10 11 12 15 

0| 1|ACT|REQ|CE | M | 0| I/0|IAK| 1 | 0| 0| STATE 
I I I I IUNIT I IPROGI I I I I 



NEXT DITP 
CURRENT REQUEST SYSBASE INDEX 



IOT I 



UNIT 



I 



LDEVN 



DLTP 



ILTP 
CURRENT DEVICE STATUS 



ERROR DEVICE STATUS 
SYSBASE INDEX OF FIRST REQUEST IN QUEUE 



SYSBASE INDEX OF LAST REQUEST IN QUEUE 



CURRENT LOGICAL 
DISK ADDRESS 



CURRENT PHYSICAL 
DISK ADDRESS 



CURRENT DATA BUFFER ADDRESS 
WORD COUNT REMAINING 



CURRENT WORD COUNT 
SYSBUF ADDRESS 



STATUS 1 RETURN 
STATUS 2 RETURN 



CYL 



HEAD I SECTOR 

STATUS 1 RETURN 

CYL 



DFLAG 



1 


DLINK 




DCURRREQP 


3 


DLDEV 


U 


DDLTP 


5 


DILTP 


6 


DSTAT 


7 


DSERR 




DQHEAD 




DQTAIL 


12 




13 


CLDA 


11+ 


CURCUL 


15 


CPDA 


16 


CDBA 


17 


WCR 


20 


CWC 


21 


SYSBUFA 


22 


STAT1 


23 


STAT2 


2k 






CEDA 


25 




26 





271 

I 

301 
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DIT FOR 7905/7906/7920/7925 (CONT.) 

I 

251 

I 

26| 

I 

271 

I " 

281 



I- 
291 

I- 
30| 

I' 
311 

I 
32| 

I 

I 



HEAD I SECTOR 

DISPLACEMENT 

PATT 1 

PATT 2 

PATT 3 

SCOUNT (SECTOR COUNT) 



INITIALIZE ADDRESS 
POINTER TO THIS DIT'S STATTAB WORD 



I I 
j31j 

•j" 'request 

|32 SYNDROME 

I I 
1331 
I I 
|3U| 
I I 
1351 

•I / 

136 



I 



137 

I 

|U0 

\kl 



I 



IOT - I/O Devices 

- Series II/III 

1 - HP- IB 
3 - unused 
U - unused 

ERROR & RETRY INFORMATION 
1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
|__|-_|„|„|„|--|~|~|~|--|"|-l"l--l~l--l 

I D| S| El M| W| 0| 0| C| C Oj 
I"l"|-I"l"l"l"l"l - I 

D - retry determination 

S - request syndrome 

E - request error info 

M - update track map 

W - writing track map 

C - issued a re calibration 



QMISC OF IOQ 
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DIT for CS 80 Disc 



There is one DIT per physical device. If a physical device represents 

more than one logical device, the logical device number is obtained 

from the IOQ element. For the CS'80 disc controller, there will only be one 

device. The following diagram shows the DIT used by the CS'80 disc driver. 

NOTE: Integrated Cartridge Tape's DIT has the same format. 

1 2 3 k 5 6 7 8 9 10 11 12 13 lb 15 MNEMONIC 

0|TM|DS|AC|RQ|CE| 0| | 10 | IA |N0 | ST | 0| STATE | DFLAG 
+__+__+__+__+__+__+_ _+__+_ _+__+__+__+ + 

1| SYSDB relative pointer to the DIT for the next| DLINK 

| device requesting this resource or service | 

+ + 

2 | Current request sysbase index I DCURREQP 

+ + + + 

3 | IOT | Phys . unit # | Logical device number | DLDEV 
+ + + + 

U| SYSDB relative pointer to Driver Linkage Table | DDLTP 

+ + 

5 | SYSDB relative pointer to Intrp Linkage Table | DILTP 
+ + 

6 | DSTAT is -1 when a system powerfail occurred | DSTAT 
+ + 

71 Hardware error status. Set when the driver | DSERR 
| detects an error. Whenever <>0, the driver | 

| monitor logs an I/O error and clears this word| 

+ + 

%10 | Sysbase index of first request in queue | DQHEAD * 
+ + 

%11| Sysbase index of last request in queue | DQTAIL * 

+--+--+ + + 

%12|LK|IF| I SUBSTATE | DMISC 
+--+--+ + + 

%13| SYSDB relative ptr to system buffer element | DSBUFADDR 

+ + 

%lk\ High order logical sector address of bad blk | DBADBLK1 
+ 1 + 

%15l Low order logical sector address of bad blk | DBADBLK2 
+ + 

%l6| Byte transfer left when bad block occurred | DBADXFER 

+ + 

%17\ Hardware logged error status - CPVA (0) | DL0GERR0R 
+ + 

%20| Channel program aborted relative offset | DSI0PST0P 

+ + 

%21| Disc status (20 bytes ) -Logged on status error | DSTATUS 

+ + 

• I • I 

+ + 

• I • I 
+ + 
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%32| I 

+ + 

DFLAG - Flags and request state 

TM TERM - Set if device is a terminal. 

DS DISC - If TM = and this bit is set then the device is 

a disc, otherwise device dependent. 
CE - Caching is enabled. 

AC ACTIVE - A monitor is currently servicing this device. 
RQ REQUEST - A service request is pending while the monitor is 

active. 
10 IOPROG - An I/O Channel Program is running for this device. 
IA IAK - An interrupt or response has occurred for this device. 
NO NOTRDY - Go to state %10 after Idle Channel Program is started. 
ST STWAIT - The device monitor is starting an Idle Channel Program 

for this device. There is no IOQ associated with this 

type of request. 
STATE - State of the device monitor. Specifies the next action 

to be taken in SIODM in servicing the request: 

- start new request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver completor procedure 
1* - not used 

5 - process request completed 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

JllO - wait for interrupt (operator intervention) 

restart at state 
%11 - wait for data segment freeze, then state 2 
%12 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 
%13 - wait for I/O completion interrupt, then state 3 
%lk - wait for controller, then call driver initiator 
%15 - not used 

%l6 - wait for initiator make present, then state 2 
%17 - wait for completor make present, then state 3 

DLINK - A SYSDB relative pointer to the next DIT requesting this 



ffie/Mirrft ni* eann r*a . 



DCURREQP - A current request sysbase index. 

T"rt\ni?\7 fC\-0\ - T /O enotam +\ma 

- HP3000 Series 2/3 

1 - HP3000 Series 33 (HPIB) 

2 - Unused 

3 - Unused 
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DLDEV. (2:6) - Unit number of this device. Zero if a single unit. 

DLDEV. (8:8) - Logical device number of this device. 

DSTAT - Set to a -1 when a system powerfail has occurred. 

DSERR - Pointer to status to be logged. 

Bits (0:7) - Number of words to be logged. 
Bits(8:15) - Offset relative to DITP(O). 

DMISC - Device dependent processing flags 

LOCK'FLG - Lock flag denoting unload status of the disc volume. 

- Allow operator unload to the volume. 

1 - Deny operator unload to the volume. 

IGNORE' INT 'FLG - Ignore unexpected interrupt flag. 
SUBSTATE - Indicates state of the idle channel program: 

- Normal idle channel program wait 

1 - Idle request being serviced wait 

DSBUFADDR - SYSDB relative pointer to the system buffer element 
used to read the DSCT. Zero, if no element gotten. 

DBADBLK1 - High order logical sector address of the bad block 
for the Defective Sector Table (DSCT) entry. 

DBADBLK2 - Low order logical sector address of the bad block for 
the DSCT entry. 

DBADXFER - Byte transfer left when bad block occurred. 

DLOGERR0R - CPVA(O) logged on hardware error status. 

DSI0PST0P - Stopped channel program relative offset location due 
to an error in CPVA(O). 

DSTATUS - 20 bytes disc status logged on status error. 
(See CS'80 Disc Drive Status). 



Caution: * Since the "C" MIT, word %10 and Jill of the DIT for 
disc devices have been used for DQHEAD and DQTAIL 
pointers for disc request queues. Word f.10 is also 
used by the timer procedure to hold a timer request 
index (DTRLX). Unless word %10 of the DIT is freed 
up in a future MIT, timers cannot be implemented on 
any disc drivers. 
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DIT for 7970/71 Magnetic Tape 

Device Information Table (DIT) 

1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 MNEMONIC 
+ — + — +--+ — +--+ — + — + — + — +--+ — +--+--+ — +--+ — + 

0| 0| 0|ACjRQ| 0|MU| 0|IO|IA| 0| 0| 0| STATE | DFLAG 
+ — +--+--+ — + — + — +--+ — + — +--+ — +--+ + 

1| SYSDB relative pointer to the DIT for the next| DLINK 

I device requesting this resource or service | 
+ __. + 

2 1 SYSDB relative pointer to the first IOQ in | DIOQP 

I request list for this device j 

+ + + + 

3|I0T I Phys. unit # | Logical device number | DLDEV 
+ + _+ + 

U| SYSDB relative pointer to Device Linkage Table | DDLTP 
+ + 

5 1 SYSDB relative pntr to Interrupt Linkage Table! DILTP 

+ + 

6|RW|RU|SH|CE|B0| |AA| DSAVE 
+ + 

7 I Hardware error pointer. Set when the driver | DSERR 
I detects an error. Whenever <>0, the driver | 
| monitor logs an I/O error and clears this word| 

%10j Bit is set at completion of timer | DTIME 

+__+ — + — +--+ — + + 

Jill I Interrupt status for this unit. Set by the | DSTAT 

I driver each time it processes an interrupt. | 
+ ^ + 

%12| Holds the time out request entry index while | DRQST 

I a timer is active. | 

+ + 

5613 1 Hardware logged error status | DL0GERR0R 



DFLAG - Flags and request state 



A("< A^WTlTtn? 

n^ nv lira 

RQ REQUEST 



MU MUNIT 

10 IOPROG 

IA IAK 

NO NOTRDY 

ST STWAIT 



n. HOni uui IS CU~ J. €ubj.y S6j.vj.Cj.xig "tlllS ueviCe . 

A service request is pending while the monitor is 

active. 

This device is on a multi-unit controller. 

An I/O Channel Program is running for this device. 

An interrupt or response has occurred for this device. 

Go to state %10 after Idle Channel Program is started. 

The device monitor is starting an Idle Channel Program 

for this device. There is no IOQ associated with this 

type of request. 
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STATE - State of the device monitor. Specifies the next action 
to be taken in SIODM in servicing the request: 

- start new request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver completor procedure 
U - not used 

5 - process request completed 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

%10 - wait for interrupt (operator intervention) 

restart at state 
%11 - wait for data segment freeze, then state 2 
%12 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 
%13 - wait for I/O completion interrupt, then state 3 
%lk - wait for controller, then call driver initiator 
%15 - not used 

%l6 - wait for initiator make present, then state 2 
%17 - wait for completor make present, then state 3 

DLDEV - I/O system type, unit and logical device number 
IOT I/O TYPE- Type of I/O system 

- HP3000 Series II/III 

1 - HP3000 Series 33 (HP-IB) 

2 - unused 

3 - unsused 

DSAVE - Device processing flags 

RW RWBIT - Indicates tape has been rewound. 

RU RWUNLD - Indicates that a rewind/unload was performed to allow a 

write-ring mount. 
SH SHORT - A short read is in progress. After completion of read, 
EOF is checked for and if not present, the requested 
bytes are trans fered from the short -read buffer to the 
user's buffer. 
CE CESTAT - Channel parity error processing is in progress. 
BO BODEOF - Backspace record due to a data EOF processing is in 

progress . 
AA AB'ACK - Abort Channel Program is executing. 
$PAGE 
DSTAT - Mag tape controller status 

BITS USE 

END OF FILE 

1 BEGINNING OF TAPE 

2 END OF TAPE 

3 SINGLE TRACK ERROR (NOT LOGGED FOR READS) 

It COMMAND REJECT 

5 FILE PROTECT 

6 MULTIPLE TRACK ERROR 
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7 UNIT ONLINE 

8 (NOT USED) 

9 UNIT NUMBER (MSB) 

10 UNIT NUMBER (LSB) 

11 TIMING ERROR 

12 TAPE RUNAWAY 

13 REWINDING * 

lU UNIT BUSY ** (REPORTED AS UNIT NOT READY) 

15 INTERFACE BUSY * 

FOR STATUS READ (3RD BYTE STATUS) DENOTES: 

BITS USE 






(NOT USED) 


1 


(NOT USED) 


2 


POWER ON 


3 


COMMAND PARITY ERROR 


1* 


*UNIT 3 PLACED ON LINE 


5 


*UNIT 2 PLACED ON LINE 


6 


*UNIT 1 PLACED ON LINE 


T 


*UNIT PLACED ON LINE 



*NOTE: BITS U,5,6,7 NOT USED BY DRIVER. 
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DIT for 7976 Magnetic Tape 



There is one DIT per physical device. If a physical device represents 
more than one logical device, the logical device number is obtained 
from the IOQ element. The following diagram shows the DIT used for 
the mag tape driver. 

1 2 3 h 5 6 7 8 9 10 11 12 13 Ik 15 MNEMONIC 

0| 0| 0|AC|RQ| 0|MU| 0|IO|IA| 0| 0| 0| STATE | DFLAG 
+ — +--+--+--+ — + — +__+__+__+__+__+__+ + 

1| SYSDB relative pointer to the DIT for the next| DLINK 

I device requesting this resource or service j 

+ + 

2 1 SYSDB relative pointer to the first IOQ in | DIOQP 

I request list for this device | 

+ — +- +- + 

31 I Phys. unit # | Logical device number | DLDEV 

+-- + + + 

k\ SYSDB relative pointer to Driver Linkage Table | DDLTP 

+ + 

51 SYSDB relative pntr to Interrupt Linkage Table | DILTP 

+ + 

6|RW|RU|SH| |DC|PF| | DSAVE 

+ + 

71 Hardware error status. Set when the driver | DSERR 

I detects an error. Whenever <>0, the driver j 

I monitor logs an I/O error and clears this wordj 

+ — + — +--+--+--+ + 

Jll0| Bit is set at completion of timer | DTIME 

+--+--+--+--+--+ + 

Jill I Interrupt status for this unit. Set by the | DSTAT 

I driver each time it processes an interrupt. j 

+ + 

%12| Holds the time out request entry index while | DRQST 

I a timer is active. j 

+- — + 

%13l Error log. Contains 5 valid bytes of status | DLOGERROR 

+ - — + 



DFLAG - Flags 

AC ACTIVE 

RQ REQUEST 

MU MUNIT 

10 I0PR0G 

IA IAK 

NO NOTRDY 

ST STWAIT 



and request state 

- A monitor is currently servicing this device. 

- A service request is pending while the monitor is 
act ive . 

- This device is on a multi-unit controller. 

- An I/O Channel Program is running for this device. 

- An interrupt or response has occurred for this device. 

- Go to state %10 after Idle Channel Program is started. 

- The device monitor is starting an Idle Channel Program 
for this device. There is no IOQ associated with this 
type of request. 
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STATE - State of the device monitor. Specifies the next action 
to be taken in SIODM in servicing the request: 
- start new request 

2 - call driver initiator procedure 

3 - call driver completer procedure 
k - not used 

5 - process request completed 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

%10 - wait for interrupt (operator intervention) 

restart at state 
5lll - wait for data segment freeze, then state 2 
#12 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 
%13 - wait for I/O completion interrupt, then state 3 
%lk - wait for controller, then call driver initiator 
%15 - not used 

%l6 - wait for initiator make present, then state 2 
%n - wait for completor make present, then state 3 



DSAVE - Device processing flags 

RW RWBIT - Indicates tape has been rewound. 

RU RWUNLD - Indicates that a rewind/unload was performed to allow a 

write -ring mount. 
SH SHORT - A short read is in progress. After completion of read, 

EOF is checked for and if not present, the requested 

bytes are trans fered from the short -read buffer to the 

user's buffer. 

DC DSFLAG - Transfer used data chaining - used for computing the 

transmi s s ion log . 
PF POWER - Device power up indication. 

DSTAT - Mag tape controller status 

BITS USE 

END OF FILE (EOF) 

1 BEGINNING OF TAPE (BOT) / LOAD POINT (LP) 

2 END OF TAPE (EOT) 

3 SINGLE TRACK ERROR (NOT LOGGED FOR READS) 

k COMMAND REJECT (REJECT) 

5 FILE PROTECT (NOT WRITE ENABLED; NO WRITE RING) 

6 MULTIPLE TRACK ERROR (MTE) 

7 UNIT ONLINE 

8 GCR (6250 BPI DENSITY) 

9 UNIT NUMBER (MSB) 
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10 UNIT NUMBER (LSB) 

11 TIMING ERROR 

12 TAPE RUNAWAY 

13 REWINDING * 

lU UNIT BUSY ** (REPORTED AS UNIT NOT READY) 

15 INTERFACE BUSY * 
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DIT for Series III Card Reader 



12 3^5 67 89 10 11 12 15 
I-I--I — I — I — I I-I-— | — I— "I — I — I 1 

j 0| 0|ACT|REQi j | | I/0|IAK|READ| NR| | MSTATE | DFLAG 
| | J i | | |PR0G| |DONE|MSG| | 



1 
2 
3 
U 

5 
6 

7 
%10 



DITP LINK TO NEXT DIT 
IOQP POINTER TO 1st REQUEST 



UNIT # 



| LOGICAL DEVICE # 
DRIVER LINKAGE TABLE POINTER 



INTERRUPT LINKAGE TABLE POINTER 
(SEE BELOW) 



ERROR STATUS IF NOT 
REQUESTED WORD COUNT 



DSTAT bits: 



BIT0=SIO OK 
BIT1=0 

BIT2=INT PENDING 
BIT3=TIMING ERROR 
BITU=LIGHT DARK CHECK 
BITS 5-6 = 00 COLUMN BINARY MODE 
01 UNUSED 

10 PACKED BINARY MODE 

11 HOLLERITH-TO-ASCII MODE 
BIT7=COMPARE ERROR 

BIT8=EOF DETECTED 

BITS 9-10 = 00 NORMAL 

01 HOPPER EMPTY 

10 UNUSED 

11 STACKER FULL 
BIT11=INVALID HOLLERITH 
BIT12=PICK FAIL OR MOTION CHECK 
BIT13=TEST 

BITlU=TROUBLE 
BIT15=NOT READY 



DLINK 
DIOQP 
DLDEV 
DDLTP 
DILTP 
DSTAT 
DSERR 
DWCNT 
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CARD READER DIT FIELD DEFINITIONS 
DFLAG - Flags and device state 

ACTIVE Monitor is currently active servicing this device. 

REQUEST Service for this device was requested while the monitor 
was active. 

IOPROG SIO program in progress. 

IAK Interrupt occurred or request aborted or preempted. 

READDONE Previous read resulted in an EOF with a backup save 
requested. The data has been saved in an auxiliary 
buffer and will be passed back on the next read request. 

NRMESSAGE Set when a not ready message has been issued, and cleared 
when the reader is found ready. Used to prevent multiple 
Not Ready messages when power is turned on. 

MSTATE Monitor State. See SIODM specifications for details. 

DLINK - SYSDB relative ponter to the DIT for the next device 
requesting service for this resource. 



DIOQP - SYSDB relative pointer to the first IOQ element in the request 
list for this device. 



DLDEV - Logical device number and unit number. 

UNIT Unit number of device. 
LDEVN Logical device number. 

DDLTP - SYSDB relative pointer to driver linkage table (DLT) . 

DILTP - SYSDB relative pointer to interrupt linkage table (ILT) . 

DSTAT - Device interrupt status. Contains the device interrupt status 
at the last interrupt. See hardware ERS for details. 

DSERR - Device interrupt error status. If not zero, then holds the 
device interrupt status from an operation with an erroneous 
completion status. Causes SIODM to log an error. 

DWCNT - Holds the requested transfer count in words. 
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DIT for HPIB Card Reader 



There is one DIT per physical device. If a physical device represents 
more than one logical device, the logical device number is obtained 
from the IOQ element. The following diagram shows the DIT used for 
the card reader driver. 

1 2 3 U 5 6 7 8 9 10 11 12 13 1^ 15 MNEMONIC 

+ — +--+--+--+ — +--+--+ — + — +--+ — +--+--+--+--+ — + 
0| 0| 0|AC|RQ| 0|MU| 0|IO| IA|N0|ST| 0| STATE | DFLAG 

+ — +--+--+--+--+ — +--+--+ — +--+--+--+ + 

1| SYSDB relative pointer to the DIT for the next| DLINK 

| device requesting this resource or service | 

+ + 

2 | SYSDB relative pointer to the first IOQ in | DIOQP 

| request list for this device | 

+ + + + 

3 | IOT j Phys. unit # j Logical device number j DLDEV 
+ + + + 

k\ SYSDB relative pointer to Driver Linkage Table | DDLTP 
+ + 

51 SYSDB relative pntr to Interrupt Linkage Table | DILTP 
+ + 

6JRDJAF! i DSAVE 

+ + 

7 | Hardware error status. Set when the driver | DSERR 
j detects an error. Whenever <>0, the driver j 
j monitor logs an I/O error and clears this word| 

+--+--+--+--+ — + + 

#10 1 Not Used I DTIME 

+--+--+--+--+--+ + 

#11 j Request word count j DWCNT 

+ + 

#12 | Device Status. Read from device during | DSTAT 
| each execution of the channel program. | 
+ + 

#13! Logging will be done from here. I DLOGERROR 

+ + 



DFLAG - Flags 

AC ACTIVE 

RQ REQUEST 

MU MUNIT 

10 IOPROG 

IA IAK 

NO NOTRDY 

ST STWAIT 



and request state 

- A monitor is currently servicing this device. 

- A service request is pending while the monitor is 
active. 

- This device is on a multi-unit controller. 

- An I/O Channel Program is running for this device. 

- An interrupt or response has occurred for this device. 

- Go to state #10 after Idle Channel Program is started. 

- The device monitor is starting an Idle Channel Program 
for this device. There is no IOQ associated with this 
type of request. 
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STATE - State of the device monitor. Specifies the next action 
to be taken in SIODM in servicing the request: 

- start new request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver corapletor procedure 
k - not used 

5 - process request completed 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

%10 - wait for interrupt (operator intervention) 

restart at state 
%11 - wait for data segment freeze, then state 2 
%12 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 
%13 - wait for I/O completion interrupt, then state 3 
%lk - wait for controller, then call driver initiator 
%15 - not used 

%l6 - wait for initiator make present, then state 2 
%1T - wait for completor make present, then state 3 

DLDEV - Device logical device number 
IOT I/O TYPE - I/O System type 

= Series II / III I/O system 

1 = HP-IB 

2 = unused 

3 = unused 

DSAVE - Device processing flags 

RD READDONE - A card has already been read. 
AF ABORTFLAG - A device clear has already been sent for 

this series of aborted IOQs. 
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LINE PRINTER DIT (SERIES I I /III) 



There is one DIT per physical device. If a physical device 
represents more than one logical device, the logical device number is 
obtained from the IOQ element. The following diagram shows the DIT 
used for IOLPRT0. 



1 2 3 U 5 6 7 8 9 10 11 12 13 l 1 * 15 

0| 0| 0|AC|RQ| 0| 0| 0|IO|AK|PS|NE|TF| STATE | 
+ — + — + — + — +--+ — + — + — +--+--+--+ — + + 

1| SYSDB relative pointer to the DIT for the next 
I device requesting this resource or service 
+ - - -i 

2 | SYSDB relative pointer to the first IOQ in 
I request list for this device 
+ + 

3| | Phys unit # | Logical device number 
+ + 

U| SYSDB relative pointer to Driver Linkage Table 
+ 

51 SYSDB relative ptr to Interrupt Linkage Table 

+____, , 

S\ Controller interrupt status. Set by GIP each 
j time it processes an interrupt for this DIT. 
I See individual field descriptions on nxt page. 

+ 

7| Hardware error pointer. Set when the driver 
i detects an error. Whenever <> 0, the driver 
! monitor logs an I/O error and clears this word 
+ 

%10| Bit is set at completion of 2-second timer. 
+ 

%11| Timer Request List Index. Not used except to 
I clear the request after timing out. 
+ + 

%12| | Last byte if odd bytcnt 

| | Data byte for VFC or 

| j left margin download 

%13|VF|PF|BT|TL|Left margin | Vertical Format Code 
|MD|RS|JB|NR| I 



+--+--+ — + — +- 



I ttnnn /n£r\Q\ _— at 1 r\r> 



Skip to channel 3 pre- 
to postspace print. 



>J.4j Lines xeix to sKip 
| (subtypes 1, 2, >15 
j line slew request) 
+ + 

%15| HARDWARE ERROR LOGGING STATUS 

+ 

%16| DVR DEPENDENT FLAGS => |PS|NE|TF| 
+--+--+ — + — +--+--+ — + — + — + — + — +--+ 



MNEMONIC 
DFLAG 

DLINK 

DIOQP 

DLDEV 
DDLTP 
DILTP 
DSTAT 

DSERR 

DTIME 
DTRLX 

DLAST 
DVFC1 



DLOGERROR 
DDF 
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DFLAG.AC - Active. A monitor is currently servicing this device. * 
DFLAG.RQ - Request. A service request is pending while the monitor 

is active. * 
DFLAG.IO - An I/O channel program is in progress. Decrement SIOCOUNT 

and check for multiple channels when complete. * 
DFLAG.AK - Interrupt Acknowledge. An interrupt has occurred. * 
DDF .PS - Prespace. The last request was a prespace (space then 

fill buffer) operation. 
DDF .NE - Not Empty. The print buffer is not empty. Causes a print 

when changing from pre- to postspace or before ejecting 

a page for a File Open, File Close or Device Close. 
DDF .TF - Top of Form. The last request ended with a skip to 

channel 1 (page eject). 

* Not examined or modified by IOLPRTO. 

DFLAG. STATE - State of the device monitor. Specifies the next action 
to be taken by SIODM in servicing the request. Not 
used within IOLPRTO. 



DSTAT.(0:1) - SIO OK. Set when no SIO channel program is in progress, 
that is, it is OK to start one. 

.(1:1) - WIO OK. Set when it is OK to execute a WIO instruction 
or a doubleword WRITE channel order. If clear, 
indicates that a one word transfer is in progress. 

.(2:1) - Interrupt Pending. If set, indicates one or more bits 
of the Interrupt Status Byte (DSTAT.(8:8) are set. 

.(3:2) - U.I. Transfer State. Used mostly for hardware mainten- 
ance. See U.I. card manual (30051-90001) for details. 

.(5:1) - Device Flag. Indicates a print-and-advance-paper 
sequence in progress. Since the 2608 buffers such 
commands, this signal may be shorter than with other 
printers . 

.(6:1) - Always 0. DSTAT.(8:8) always contains the Interrupt 
Status Byte. 

rays 0. 

according to 



• 


(7:1) 
(8:3) 


- Not used. Always 0. 

- Varies among HP-supported 

the table below: 


line 


printers 


SUBTYPE 


MODEL (S) 




BIT 8 


BIT 9 


BIT 10 







2610, 26lU 




LINE 
PRINTED 


READY 


NOT 
READY 


1 




2607 




Not 
used 


READY 


NOT 

READY 


2 




2613, 2617, 
2619 


2618, 


Not 
used 


READY 


NOT 

READY 


3 




261 7 J (KATAKANA) 


Not 
used 


READY 


NOT 

READY 


1* 




2608 




ON 

LINE 


NOT 

READY 


VFC 

CHAN 9 
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.(11:1) 
.(12:1) 
.(13:1) 



(l*t:l) 



Data Transfer Interrupt bit. Always 0. 
Not used. Always 0. 

Programmed Interrupt bit. True if interrupt request 
was generated by: 

a) SIN machine instruction, 

b) INTERRUPT channel order, or 

c) END -WITH -INTERRUPT channel order 
Transfer Error Interrupt bit. True 

generated by: 

a) an illegal memory address, 

b) a memory parity error, or 

c) a multiplexer parity error during data xfr to 
(15:1) - Time-out Interrupt bit. Set if 5-second timer on 

card is enabled, then times out without 
cleared. 



if interrupt was 



U.I. 

U.I. 

being 



DLAST.(8:8) 



DVFC1.(0:1) 
DVFC1.(1:1) 

DVFC1.(2:1) 

DVFC1.(3:1) 
DVFC1.(U:U) 

DVFC1.(8:8) 



Request dependent. If a print request has an odd 
number of bytes, this word holds the final byte. For 
VFC downloads, contains the associated data byte (6 
or 8 lines per inch and number of lines in VFC). For 
left margin downloads, also contains the associated 
data byte (the number of columns to offset). 

VFC Modified. 2608 only. Indicates that an external 
VFC has been downloaded into the 2608. 

Power Fail/Reset. 2608 only. The 2608 has suffered a 
Power Failure or someone has pressed the front panel 
Reset button. In either case, the printer's operating 
environment has been destroyed, and must be reloaded 
by the operator. 

Between Jobs. Set when a Device Close is executed, 
cleared when an FOPEN is performed. 2608 Power Fail/ 
Master Reset's will be cleared but not reported while 
this bit is set (thus avoiding an extraneous console 
message when the printer is powered up) . 

TALLY 'NOT 'READY. Set when an off-line condition 

is detected on a 2607. Causes a three-second 

delay when the 2607 comes back on-line. 

Left margin offset (2608 only). Stored during 
each : DOWNLOAD which specifies a left margin 
and restored to printer following a 2608 power 
fail or reset. Set to when system is ini- 



xisiiizea. 



Request dependent. Contains the carriage control 
sent to the printer during a print request. 



byte 
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DVFC2.(0:8) - LINES 'LEFT' OVER. Has two functions: 

1) The 2607/13/17/18/19 can only slew (skip) a 
maximum of 15 lines per print command (not 
counting VFC skips, which can be of any 
length) . Slew requests > 15 lines must be 
broken up. This byte holds the number of 
lines (greater than 15) which remain to be 
slewed at any point of a request to such a 
printer, or if the number of lines to skip 
is <= 15. This mechanism is not needed (and 
this field is therefore 0) for CDC and 2608 
line printers, which can slew up to 63 lines 
at a time. 

2) The carriage control characters "0" and "-" 
specify double and triple spacing, respective- 
ly. But if you use the equivalent channel 
skip, you get skips to the next odd and third 
lines, respectively, which is not the same as 
double and triple spacing. If you slew (ad- 
vance paper) 2 or 3 lines, you can easily 
print over the paper perforations unless your 
program watches out for such things. We avoid 
this by examining the NO' AUTO' PAGE eject bit 
(I0Q(QPAR2).(lU:l)). If it is set, then the 
request is treated like a normal slew and 
LINES' LEFT 'OVER is not used. If it is clear 
(auto eject desired), then we simulate the 
multiple line skip by doing two ("0") or three 
("-") skips to channel 3 (single spaces with 
auto page eject for the standard VFC). In 
this case, LINES 'LEFT 'OVER holds the number of 
such single spaces remaining in the request. 

a 1990 

DVFC2.(8:8) - %202 for 2608, %102 otherwise. Causes skip to channel 
3 (single space with auto page eject) . Used when 
last request left data in print buffer (prespace) and 
current operation is postspace. Buffer is dumped 
first, using this byte as carriage control. 
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2608 LINE PRINTER DIT (HPIB SYSTEMS) 



There is one DIT per physical device. If a physical device represents 
more than one logical device, the logical device number is obtained 
from the IOQ element (however, there is only one device per 2608 
controller.) The following diagram shows the DIT used for the 
2608 line printer driver. 

1 2 3 h 5 6 7 8 9 10 11 12 13 lU 15 MNEMONIC 
+ — + — +__+__+ — +__+__+ — + — +__+__+__+__+__+__+__+ 

0| 0| 0|AC|RQ| 0| 0| 0|IO|IA|NO|ST| 0| STATE | DFLAG 

1| SYSDB relative pointer to the DIT for the next| DLINK 

I device requesting this resource or service | 

+ + 

2 1 SYSDB relative pointer to the first IOQ in | DIOQP 

I request list for this device | 

+ + + + 

3JIOT I Phys. unit # | Logical device number | DLDEV 
+ + + + 

U| SYSDB relative pointer to Driver Linkage Table | DDLTP 
+ + 

51 SYSDB relative pntr to Interrupt Linkage Table j DILTP 
+ + 

6|VM| I TAB I I PS I FL I TP I DSAVE 
+ + 

7| Hardware error pointer. Set when the driver | DSERR 

I detects an error. Whenever <>0, the driver | 

j monitor logs an I/O error and clears this word| 
+_.+ + + +__+__+__+ 

%10| Bit is set at completion of timer j DTIME 

+__+ + + +__+__+__+ 

Jtll I Holds the time out request entry index while | DRQST 

I a timer is active. 1 

+ + 

%12| Hardware logged error status | DLOGERROR 
+ + 



DFLAG - Flags 

AC ACTIVE 

RQ REQUEST 

10 IOPROG 

IA IAK 

NO NOTRDY 

ST STWAIT 



and request state 

- A monitor is currently servicing this device. 

- A service request is pending while the monitor is 
active. 

- An I/O Channel Program is running for this device ^ 

- An interrupt or response has occurred for this device. 

- Go to state #10 after Idle Channel Program is started. 

- The device monitor is starting an Idle Channel Program 
for this device. There is no IOQ associated with this 
type of request. 
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STATE - State of the device monitor. Specifies the next action 
to be taken in SIODM in servicing the request: 

- start new request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver completor procedure 
h - not used 

5 - process request completed 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

%10 - wait for interrupt (operator intervention) 

restart at state 
%11 - wait for data segment freeze, then state 2 
%12 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 
%13 - wait for I/O completion interrupt, then state 3 
%lk - wait for controller, then call driver initiator 
%15 - not used 

%l6 - wait for initiator make present, then state 2 
%17 - wait for completor make present, then state 3 

DLDEV - I/O system type, unit and logical device number 
IOT I/O TYPE- Type of I/O system 

- HP3000 Series II/III 

1 - HP3000 Series 33 (HP-IB) 

2 - unused 

3 - unsused 

DSAVE - Device processing flags 

VM VFCMOD - VFC has been modified. 

TAB TABDFAULT - System tab default. 

PS PRESPACE - Last request used prespacing. 

FL FULL - Line printer buffer is full. 

TP TOP - Printer is at top of form 
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2608 Line Printer Status 



BYTE 1 & BYTE 2: 
BITS USE 

ON LINE 

1 NOT READY 

2 VFC CHANNEL 9 (BOTTOM OF FORM) 

3 VFC CHANNEL 12 (TOP OF FORM) 

k VFC INITIALIZED 

5 6/8 LINES PER INCH 

6 (NOT USED) 

7 POWER RESTORED/UNIT RESET 

8 ON LINE 

9 PRINT MECH ERROR 



10 
11 
12 

13 
11* 

15 



SELF TEST FAILURE 
PAPER ERROR 
SELF TEST MODE 

6/8 LPI 

PLATEN/RIBBON ERROR 
(NOT USED) 

BYTE 3: PRINT MODE 

BITS 0-7 MODE NUMBER 
BYTE U: PRIMARY/SECONDARY 

BITS 0-3 SECONDARY CHARACTER SET CODE 

BITS U-7 PRIMARY CHARACTER SET CODE 
BYTE 5: SELF TEST 

BITS PASS FAIL 

BITS 1-7 SUBTEST NUMBER 
BYTE 6: 6 LPI DOT ROW COUNT 
BYTE 7: 6 LPI FORM LINE NUMBER 
BYTE 8: 6 LPI FORM LENGTH IN LINES 
BYTE 9: 8 LPI DOT ROW COUNT 
BYTE 10: 8 LPI FORM LINE NUMBER 

BVTPF 11. Q T T3T VfSGM T VWrmj TVT T TITPCT 

W1XD J. J. • V Ul J. IT V1U1 JJU11UA1A J.« U111UU 

BYTE 12: FIRMWARE IDENTIFICATION CODE 
BYTE 20: POWER-UP LANGUAGE 

BITS 0-3 SECONDARY CHARACTER SET CODE 
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HIOCIPRO DIT (HP2608S) 



There is one DIT per physical device. If a physical device represents 
more than one logical device, the logical device number is obtained 
from the IOQ element (however, this driver only supports one device per 
controller.) The following diagram shows the DIT used for the HP- IB 
CIPER physical driver. 



Word # 





1 


2 


3 


U 


5 


6 


7 


8 


9 


10 


11 


12 


13 lU 15 


MNEMONIC 











AC 


RQ 











10 


IA 


NO 


ST 









1 


SYSDB relative pointer to the DIT for the next 
device requesting this resource or service 


DLINK 


2 


SYSDB relative pointer to the first IOQ in 
request list for this device 


DIOQP 


3 


IOT 


Phys. unit # 


Logical device number 


DLDEV 


k 


SYSDB relative pointer to Driver Linkage Table 


DDLTP 


5 


SYSDB relative pointer to Intrp Linkage Table 


DILTP 


6 


VS 


AB 


RE 


TP 


NR 


NR CNT 


DEVICE STATUS 




7 


Hardware error status. Set when the driver 
detects an error. Whenever <0, the driver 
monitor logs an I/O error and clears this word 


DSERR 


8 


Bit is set at completion of timer 


DTIME 


9 


Holds the time out request entry index while 
a timer is active. 


DRQST 


10 


RF 


UE 


DE 


TO 


UNIT CNT 


DATA CNT 


TO CNT 


PRTY CNT 




11 


Error logging location #1 


DLOGERR0R 


12 


Error logging location #2 


DLOGCOUNT 



DFLAG - Flags and request state 

AC ACTIVE - A monitor is currently servicing this device. 

RQ REQUEST - A service request is pending while the monitor is 
active. 
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10 I0PR0G 

IA IAK 

NO NOTRDY 

ST STWAIT 

STATE 



An I/O Channel Program is running for this device. 

An interrupt or response has occurred for this device. 

Go to state ?110 after Idle Channel Program is started. 

The device monitor is starting an Idle Channel Program 
for this device. There is no I0Q associated with this 
type of request. 

State of the device monitor. Specifies the next action 
to be taken in SIODM in servicing the request: 

- start new request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver completor procedure 
k - not used 

5 - process request completed 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

%10 - wait for interrupt (operator intervention) 

restart at state 
%11 - wait for data segment freeze, then state 2 
%12 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 
%13 - wait for I/O completion interrupt, then state 3 
%lk - wait for controller, then call driver initiator 
%15 - not used 

%l6 - wait for initiator make present, then state 2 
%17 - wait for completor make present, then state 3 

DLDEV - I/O system type, unit and logical device number 

- HP3000 Series 2/3 

1 - HP3000 Series 33 (HPIB) 

2 - Unused 

3 - Unused 

DSAVE - Device processing flags 

VS - VALID STATUS - Set to indicate Device Status has been updated. 
AB - DVRABFLAG - Sequence Abort in progress due to ABORT request. 

- Sequence Abort in progress due to an error. 

- Current error is due to software timer popping. 

- Not Ready Wait in progress. 

- Number of Not Ready Waits during this request. 

- Device status returned during a Sequence Abort. 



RE - RETRYFLAG 
TP - TIMERPOPPED 
NR - NOTRDYFLAG 
NR CNT 
DEVICE STATUS 
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BIT 8 
BIT 9 
BIT 10 
BIT 11 
BIT 12 
BIT 13 
BIT 1U 
BIT 15 



CRC available and enabled. 

Reserved. 

Reserved. 

Reserved. 

Power fail or reset has occurred. 

A protocol error has been detected. 

A parity error has been detected. 

The peripheral has data to send. 



DSERR - Pointer to status to be logged. 



Bits. (0:8) 
Bits. (8:8) 

DCOUNTS 

RF - REQ FAILED 

UE - UNIT ERROR 

DE - DATA ERROR 

TO - TIME OUT 

UNIT CUT 

DATA CNT 

TO CNT 

PRTY CNT 



- Number of words to be logged. 

- Offset relative to DITP(O). 

- Error flags and error counts (U). 

- An error has forced this request to be aborted. 

- The current error is a Unit Error. 

- The current error is a Data Error. 

- The current error is a GIC Time Out Error. 

- Number of Unit Errors during this request. 

- Number of Data Errors during this request. 

- Number of GIC Time Outs during this request. 

- Number of HP-IB Parity Errors during this request. 
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2631 OR 2619A LINE PRINTER DIT (FOR HPIB SYSTEMS) 



There is one DIT per physical device. If a physical device represents 
more than one logical device, the logical device number is obtained 
from the IOQ element (however, there is only one device per 2631 
controller.) The following diagram shows the DIT used for the 
2631 line printer driver. 

1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 MNEMONIC 

+__+ — +--+ — + — +--+ — + — +--+ — +--+ — +--+--+ — + — + 
0| 0| 0|AC|RQ| 0| 0| 0|I0|IA|N0|ST| 0| STATE | DFLAG 

+ — +__+__+__+ — + — + — +--+ — +--+ — + — + + 

1| SYSDB relative pointer to the DIT for the next| DLINK 

I device requesting this resource or service | 

+ + 

2 1 SYSDB relative pointer to the first IOQ in | DIOQP 

I request list for this device j 

+ + + + 

3|I0T I Phys. unit # | Logical device number | DLDEV 

+ +— - + + 

U| SYSDB relative pointer to Driver Linkage Table! DDLTP 

+ + 

5j SYSDB relative pntr to Interrupt Linkage Table j DILTP 
+— + 

6\ |BJ|AB|PS|FL|TP| DSAVE 

+- + 

7 1 Hardware error status. Set when the driver | DSERR 
j detects an error. Whenever <>0, the driver | 
j monitor logs an I/O error and clears this word| 
+ -_...- + 

JllO 1 , Bit is set at completion of timer ! DTIME 

+ + 

%11| Holds the time out request entry index while | DRQST 
j a timer is active. I 

+ - + 

%12| Hardware logged error status I DL0GERR0R 
+ + 



DFLAG - Flags 

AC ACTIVE 

RQ REQUEST 

10 IOPROG 

IA IAK 

NO NOTRDY 

ST STWAIT 



and request state 

- A monitor is currently servicing this device. 

- A service request is pending while the monitor is 
active. 

- An I/O Channel Program is running for this device. 

- An interrupt or response has occurred for this device. 

- Go to state JllO after Idle Channel Program is started. 

- The device monitor is starting an Idle Channel Program 
for this device. There is no IOQ associated with this 
type of request. 
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STATE - State of the device monitor. Specifies the next action 
to be taken in SIODM in servicing the request: 

- start new request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver completor procedure 
k - not used 

5 - process request completed 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

%10 - wait for interrupt (operator intervention) 

restart at state 
%11 - wait for data segment freeze, then state 2 
Jtl2 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 
%13 - wait for I/O completion interrupt, then state 3 
%lk - wait for controller, then call driver initiator 
%15 - not used 

%l6 - wait for initiator make present, then state 2 
%17 - wait for completor make present, then state 3 

DLDEV - I/O system type, unit and logical device number 
IOT I/O TYPE - Type of I/O system 

- HP3000 Series 2/3 

1 - HP3000 Series 33 (HPIB) 

2 - Unused 

3 - Unused 

DSAVE - Device processing flags 

BJ BETJOB - Between jobs flag. If set, suppress 

Powerfail message. 
AB ABORT - Abort (caused by Powerfail or Operator) 
has occurred. 

- Last request used prespacing. 

- Line printer buffer is full. 

- Printer is at top of form 



PS 


PRESPACE 


FL 


FULL 


TP 


TOP 
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2680A DIT 

1 2 3 ** 5 6 7 8 9 10 11 12 13 l 1 * 15 
+__+ — + — + — + — + — + — +__+__+ — + — +__+__+_-+-_+-._+ 

DITO !0 !0 !AC!RQ!0 !0 !SP!CP!IA!NR!SW! ! STATE ! DFLAG 

1 ! POINTER TO NEXT DIT ! DLINK 

2 ! POINTER TO ACTIVE IOQ OR ZERO I DIOQP 

3 ! IOT 1 UNIT NUMBER ! LOGICAL DEVICE NUMBER J DLDEV 
It 1 DRIVER LINKAGE TABLE POINTER 1 DDLTP 

5 I INTERRUPT LINKAGE TABLE POINTER ! DILTP 

6 1 SPECIAL ERROR CONDITIONS TO BE LOGGED ! DSTAT 
J l ERROR LOGGING INFORMATION i DSERR 

8 !T 1 TIMEOUT INDICATION IN BIT ! DTIME 

9 ! TIMER REQUEST INDEX (TRL) OR ZERO 1 DTRLX 

10 ! CURRENT DATA WRITE BYTE COUNT 1 DCBCNT 

11 I CURRENT DATA WORD COUNT ! DCWCNT 

12 ! # OF WORDS LEFT TO TRANSFER ! DRCNT 

13 I BUFFER OFFSET FOR NEXT # OF WORDS TO XFER. ! DOFFSET 
,FLAG=ON 

lU ! ID! DDEBUG 

15 ! I/O STATUS BLOCK WORD 1 GETS LOGGED FROM HERE ! DLOGBUFFER 

16 ! I/O STATUS BLOCK WORD 3 GETS LOGGED FROM HERE 1 

17/32 ! I/O STATUS AREA (16 WORDS, SEE DEFINITION) ! DIOSTAT 
+--+--+ — +--+--+ — +--+--+--+ — +--+--+ — +--+--+--+ 

DFLAG - DEVICE RELATIVE FLAGS. 

AC ACTIVE BIT. 1 IMPLIES A MONITOR CURRENTLY 

SERVICING THIS DEVICE. 
RQ REQUEST BIT. 1 IMPLIES SERVICE REQUESTED 

WHILE MONITOR IS ACTIVE. 
SP SIO PREEMPTION. IF SET THEN A PREEMPTIVE 

REQUEST HAS BEEN QUEUED FOR THIS DEVICE. 

PREEMPT CODE IS SET IN IOQ ELEMENT. 
CP CHANNEL PROGRAM IN PROGRESS. IF SET, THEN 

A CHANNEL PROGRAM IS CURRENTLY EXECUTING. 
IA IF SET, AN INTERRUPT OR RESPONSE HAS OCCURED. 
NR IF SET, DEVICE IS IN A NOT READY OR OPERATOR WAIT. 
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SW IF SET, AN IDLE CHANNEL PROGRAM SHOULD BE STARTED 

FOR THIS DEVICE. 
MSTATE CURRENT DRIVER STATE AS DEFINED BY THE MONITOR. 

ALLOWABLE STATES ARE: 

- START REQUEST 

1 - NOT USED (BUT RESERVED) 

2 - CALL DRIVER INITIATOR 

3 - CALL DRIVER COMPLETOR 
k - UNUSED (BUT RESERVED) 

5 - COMPLETE REQUEST.. PERHAPS RETURN TO USER. 

6 - UNEXPECTED INTERRUPT OCCURRED. 

7 - START OPERATOR INTERVENTION WAIT. 
%10 - WAITING (ON OPERATOR). RESTART AT 0. 

11 - WAITING (DATA MAKEPRESENT/FREEZING) 

12 - WAITING (INITIATOR CODE MAKEPRESENT/FREEZE ) 

13 - WAITING (FOR COMPLETION INTERRUPT) 

ll» - WAITING (FOR DEVICE CONTROLLER AVAILABILITY) 

15 - UNUSED (BUT RESERVED) 

16 - WAITING (INITIATOR CODE MAKEPRESENT) 

17 - WAITING (COMPLETOR CODE MAKEPRESENT) 

DLDEV - I/O SYSTEM TYPE, UNIT AND LOGICAL DEVICE NUMBER. 
IOT I/O SYSTEM TYPE. 

- HP3000 SERIES II/III (SIO/DIO) 

1 - HP- IB 

2 - RESERVED 

3 - RESERVED 

DCBCNT - CURRENT BYTE COUNT TO BE TRANSFERRED. 

DCWCNT - CURRENT WORD COUNT TO BE TRANSFERRED. 

DRCNT - REMAINING WORD COUNT TO TRANSFER. 

DOFFSET - OFFSET IN BUFFER OF NEXT # WORDS TO TRANSFER. 

DDEBUG - IF BIT 15=1 THEN DEBUGGING INFO WILL BE SENT TO CONSOLE 

DLOGBUFFER - STATUS WORDS 1 & 3 ARE MOVED HERE TO BE LOGGED 
IF THEY WERE LOGGED FROM THE I/O STATUS BLOCK 
THEIR CONTENTS MIGHT BE CHANGED BEFORE THEY 
WERE LOGGED. 

DIOSTAT - I/O STATUS AREA 16 WORDS, SEE I/O STATUS BLOCK DEFINITION. 
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I/O STATUS BLOCK 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
+ — +--+--+ — +--+--+ — +--+--+ — +--+--+ — + — +--+ — + 

JO 1--THE "OR" OF WORDS 1/lp IS LOCATED HERE i 

+__+__+ — +__+__+ — + — +--+ — + — +--+--+ — + — +__+--+ 

1 !OF!MS!PW!PE!TE! ! 1 ! I ! ! ! S ! 1 ! 

2 1 ! I I ! 1 (RESERVED) 1 i i i i i i 
+ — + — + — +--+--+ — +--+ — + — + — +--+ — + — +--+ — + — + 

3 ! MCS FAULT NUMBER 1 

k !CL!FL!VL!CU!FU!VU!IL!IP!ST!SB!IR!MP!NJ!NM!TL!NC1 
+ — +--+ — + — +--+ — + — + — + — +--+ — +--+ — + — + — +--+ 

5 !LP!PS!NC! ! ! (RESERVED) !!!!!!! 
+--+--+--+--+ — + — +--+--+ — + — +--+--+ — + — + — +--+ 

6 !PL!OP!IP! ! I (RESERVED) J ! I J ! I 1 



7 ! 



i 1 



8 ! i ! i 



9 1 ! ! 



10 I ! ! ! 



! (RESERVED) J 1 ! I 



I 1 



! (RESERVED) ! I 1 ! ! S ! 



! (RESERVED) ! I 1 I ! ! I 



I (RESERVED) ! ! 1 ! ! 



! 



11 ! ! ! ! ! ! (RESERVED) 1 ! 1 ! ! ! ! 
+--+--+ — + — +--+--+--+ — + — +--+--+ — +--+ — + — +--+ 

12 ! RECORD NUMBER OF ERROR 1 
+-- IF WORD k TO 6 <> --+ 

13 ! NON-ZERO 1 
+--+--+--+--+--+--+--+--+--+ — +--+--+ — +--+--+--+ 

14 S SHEET NUMBER OF ERROR IF WORD k TO 6 <> I 
+-- OR --+ 

15 i LAST SHEET TRANSFERRED IF "JOB" & POWER-ON ! 
+ — +--+ — + — + — +--+--+--+--+ — + — +--+ — + — +--+ — + 



UXX A I 

18 
19 

20 
21 
22 
23 
2k 

25 
26 

27 
28 

29 
30 
31 
32 



WORD 



WORD 1 - 



EACH BIT IS THE 'OR' OF ONE WORD IN THE TABLE (EXCEPT 
BIT WHICH IS NOT USED). THEREFORE, BIT .(1:1) IS SET 
IF WORD 1 IN THE TABLE IS NON-ZERO. 



BIT= - (OF) 

1 - (MS) 

2 - (PW) 

3 - (PE) 
U - (TE) 

5/15 " 



ONLINE/OFFLINE BIT. 

MESSAGE BEING DISPLAYED ON THE 2680A CONSOLE. 
POWER UP COMPLETED SINCE LAST I/O STATUS READ. 
PARITY ERROR DETECTED ON PHI COMMAND. 
TRANSMISSION ERROR DETECTED IN THE PRINTER. 
RESERVED. UNUSED. 



WORD 2 
WORD 3 



NOT USED. RESERVED. 

MCS FAULT NUMBER. CONTAINS AN INTEGER DESCRIBING THE LAST 
FAULT TO OCCUR SINCE THE LAST TIME THE I/O STATUS WAS READ 
OR THE HP2680A WAS POWERED DOWN. IF THE WORD IS ZERO THERE 
IS NO MCS FAULT. SEE DCS ERS FOR A DESCRIPTION OF THE MCS 
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WORD U - BIT= 



- 

1 - 

2 - 

3 - 

k - 

5 - 

6 - 

7 - 

8 - 



9 

10 
11 



12 - 



13 



lit - 



15 - 



(CL) NO ROOM FOR ATTEMPTED CHARACTER SET LOAD. 

(FL) NO ROOM FOR ATTEMPTED FORM LOAD. 

(VL) NO ROOM FOR ATTEMPTED VFC LOAD. 

(CU) ATTEMPT TO PRINT DATA AND THERE IS NO CURRENTLY 

SELECTED CHARACTER SET. 

(FU) ATTEMPT TO SELECT AN UNDEFINED FORM SET. 

(VU) ATTEMPT TO PRINT DATA AND THERE IS NO CURRENTLY 

SELECTED VFC SET. 

(IL) ATTEMPT TO PRINT DATA AND THERE IS NO CURRENTLY 

SELECTED LOGICAL PAGE TABLE (LPT) ENTRY. 

(IP) ATTEMPT TO MOVE PEN OFF THE LOGICAL PAGE. 

(ST) THE 2680A COULD NOT PROCESS ALL OF THE DATA 

BEFORE IT WAS SUPPOSED TO BE TRANSFERRED TO THE 

DRUM/PAPER. DATA WAS LOST! 

(SB) SPOOLER BLOCK CONTAINS FORMAT ERROR. 

(IR) INVALID RECOVERY BLOCK RECEIVED FROM SPOOLER. 

(MP) MAXIMUM NUMBER OF COPIES PER PHYSICAL PAGE 

HAS BEEN EXCEEDED. THIS IS A RESULT OF THE 

SPOOLER PROCESS SETTING THE MAXIMUM COPIES PER 

PAGE WITH FUNCTION CODE 132. 

(NJ) A COMMAND OR FUNCTION CODE WAS RECEIVED WHEN NO 

"JOB" WAS IN PROGRESS. THE COMMAND OR FUNCTION WAS 

IGNORED BY THE DCS. 

(NM) NO MEMORY. 2680A DYNAMIC MEMORY ALLOCATION HAS 

DETECED THAT MAIN MEMORY IS COMPLETELY OCCUPIED WITH 

CHARACTER SETS, VFC'S, FORMS AND DATA SUCH THAT THE 

2680A CANNOT PROCESS THE CURRENT INPUT DATA. DATA 

WILL BE LOST! 

(TL) ATTEMPT TO PRINT DATA AND THERE ARE MORE THAN 

THE MAXIMUM ALLOWABLE LOGICAL PAGE TABLE (LPT) 

ENTRIES SELECTED. 

(NC) A NON-EXISTENT VFC CHANNEL WAS SKIPPED TO. 



WORD 5 - BIT= 



WORD 6 - BIT= 



2 

1 



(LP) LOGICAL PAGE TRUNCATED TO FIT PHYSICAL PAGE. 

(PF) PAGE SIZE PEQUIRED BY PROGRAMMER DID NOT 

MATCH PAGE SIZE SET BY OPERATOR. OPERATOR PAGE 

SIZE PREVAILS. 

(NC) NO CHARACTER SET SELECTED. 

(PL) NOT ENOUGH MEMORY FOR PICTURE DOWNLOAD. 

(OP) ATTEMPT TO PRINT MORE THAN 6k PICTURES ON A 

PHYSICAL PAGE. 
(IP) ATTEMPT TO PRINT A PICTURE WHICH IS NOT PRESENT. 



WORDS 7/11 



NOT USED. RESERVED FOR FUTURE USE. 



WORDS 12/13 ~ THE RECORD NUMBER WHICH CONTAINS THE OFFENDING ERROR 

AS DEFINED BY WORD FOUR. IF A POWER FAIL OCCURS DURING 
A "JOB", THE POWER FAIL BIT IS SET AND A SHEET NUMBER IS 
MADE AVAILABLE IN WORDS FOURTEEN AND FIFTEEN. HOWEVER, 
THE RECORD NUMBER IS LOST AND CANNOT BE REPORTED. THESE 
WORDS OCCUR IN A "JOB" ONLY. 
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WORDS lU/15 - THE SHEET NUMBER ON WHICH THE ERROR OCCURED AS DEFINED 

BY WORD FOUR. IF AN ERROR OCCURS IN THE ENVIRONMENT FILE 
AT THE START OF A "JOB", THEN THIS NUMBER WILL BE ZERO. 
IN ADDITION. WHEN A POWER FAIL OCCURS DURING A "JOB", 
THE POWER ON BIT IS SET IN WORD ONE AND THE SHEET 
NUMBER OF THE LAST SUCCESSFULLY TRANSFERRED PAGE IS 
PLACED HERE. THIS INFORMATION IS FOR USE BY THE 
SPOOLER SHOULD A RECOVERY OF A "JOB" BE DETERMINED. 
THESE WORDS OCCUR IN "JOB" ONLY. 

ALL WORDS OF THE I/O STATUS ARE CLEARED WHENEVER THE STATUS BLOCK 
IS RETURNED TO THE HOST. IT IS UP TO THE HOST CPU TO RETAIN ANY ON- 
GOING STATUS BITS REQUIRED. 

QMISC - 

1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 

+--+--+--+ +--+--+--+--+ + +--+ 

IOQ3 !MB!RB!AB!IO!TO! ! XFER ! PARITY ! ! QMISC 
+ — +--+ — + + — +--+ — +--+ + + — + 



WHERE: 
.(0:1) 



MB 



USER REQUESTED TRANSFER IN EXCESS OF U096 
WORDS. THE DRIVER CAN WRITE UP TO U096 WORDS 
TO THE 2680A. IN ORDER TO HANDLE UP TO 32K 
WORDS, MULTIPLE WRITES ARE USED WITHOUT A 
RETURN TO THE USER WHO CALLED THE DRIVER. 
THIS BIT INDICATES THAT MULTIPLE WRITES ARE 
BEING DONE TO THE 2680A. 



•(1:1) 


- RB 


•(2:1) 


- AB 


.(3:1) 


- 10 


•(U:l) 


- TO 


.(5:*0 


- RESE] 


Irs _ «>\ 


" A££i£\ 



THE CURRENT WRITE BLOCK MUST BE RETRIED. 
USER REQUESTED ABORT IN PROGRESS FLAG. 
I/O STATUS HAS BEEN READ AND IS AVAILABLE. 
GENERAL I/O CONTROLLER TIMED OUT. 



- RESERVED NOT CURRENTLY USED. 






(12:3)- PARITY 



CHANNEL PROGRAM COMMAND PARITY ERROR COUNTER. 



/«t ^ «i \ nnnnnTTnn %Ty**m / 1 iTYr»T"iTTiMmT IT TTr*c<T"v 



**NOTE** IN THE ABOVE, SINGLE BIT FIELDS ARE AS DEFINED 
WHEN THE BIT IS A LOGIC "1" . 
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30119 CARD READER/PUNCH DIT 

Everything is the same as the SIO DIT 
and standard IOQ except as noted below: 



1. DIT (9) 



1 2 3 k 56789 10 11 12,13 lU 15 

|C |S |S |H |I |E |I |P |P |S |E |S |M |C |T | 

%H I B I I I I I I I I I I P I I I I I I DACCP 

I F| C| S| S| F| F| B| R| N| D| C| m| D | N| R| 

I I I I I I I I I I I I I E I I I 



DIT(9).(0:1) 



CBF Clear Buffer Full - 0= the next card leaving 
the hopper will be read by the device. 
1= the read buffer will be cleared when 
next card leaves the hopper. 



DIT(9).(1:1) 


SC 


DIT(9).(2:1) 


SS 


DIT(9).(3:1) 


HS 


DIT(9).(1»:1) 


I IF 


DIT(9).(5:D 


EOF 


DIT(9).(6:1) 


IB 


DIT(9).(7:1) 


PR 


DIT(9).(8:1) 


PN 


DIT(9).(9:D 


SPD 


DIT(9).(10:1) 


EC 



Stacker Control - 0=all cards are stacked in 
right hopper until device goes not ready. 
1= cards are stacked per bit 2. 

Stacker Select - 0=Right stacker (stacker 1) 
1= Left Stacker (stacker 2). 

Hopper Select - 0= Pick from rear hopper 
(primary hopper) . 1= Pick from front hopper 
(secondary hopper). 

Inhibit Input Feed - Inhibit picking a card 
when card currently in wait station is eject 
to a hopper. 

End Of File has been detected on a read oper 

Internal Buffer -An internal buffer is being 
used. The buffer is the SIO area in the ILT. 

Print - Print on the next card to pass the 
print station. 

Punch - Punch 80 columns of data on the next 
card to pass the punch station. 

Separate Print Data - Print data other than 
that being punched on the next card to pass 
the punch and print station. 

Eject Card - Eject on a write after a read. 
Used when reading one card then punching one 
card (last card was read). 
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30119 CARD READER/PUNCH (CONT. ) 



DXT(9),(11:1) 
DIT(9).(12:2) 

DIT(9).(lU:l) 
DIT(9).(15:D 



Sm 
MODE 



CON 



TR 



Stacker Mode -Saved staker mode on last- read 

Access Mode - 

0= File opened for Read only 
1= File opened for Write only 
2= File opened for Read/Write 

Control - 0= no FCOMTRL has occured for this 
file (use default settings). 1= FCONTROL has 
been done on this file (use settings in this 
DIT word for controlling this device). 

Timer Request - A timer request is pending. 
Timer request index is in word %12. 



2. DIT(IO) Timer request index (see DIT(9) . (15:1)) , 



3. QMISC{IOQ(U)) 
1 2 3 h 



5 6 7 8 9 10 11 12 13 Ik 15 



U IN |W I 
I I R I I 
I 0| I| R| 



UNUSED 



IOQ(U).(0:1) 
IOQ(U).(l:l) 
IOQ(U).(2:l) 



-. # * % 



loqw.u: 13; 



10 I/O initiated - waiting for completion 
interrupt . 

NRI Waiting for a "Not Ready Interrupt" to 
bring the device back online. 

WR Write - current operation is a write 
operation. 

Not Used 
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INP DIT 



DITO 
1 
2 

3 

It 

5 
6 

7 
8 

9 

10 

n 

12 
13 
Ik 

15 
16 

17 
18 

19 
20 
21 
22 
23 



1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 
+__+ + + + + + 

|AC|RQ|TI| 0|PR|IO|IN|SM|MAMSTATE| IOSTATE 



POINTER TO NEXT DIT 



INPUT REQUEST QUEUE 

| LOGICAL DEVICE NUMBER 



DRIVER LINKAGE TABLE POINTER 
INTERRUPT LINKAGE TABLE POINTER 



INTERRUPT STATUS 

SOFTWARE TIMER REQUEST INDEX 



TO | 



READY QUEUE HEAD POINTER 



READY QUEUE TAIL POINTER 
ACTIVE QUEUE HEAD POINTER 



ACTIVE QUEUE TAIL POINTER 
WAITED QUEUE HEAD POINTER 



WAITED QUEUE TAIL POINTER 
EO|WP|TR| |PFSTATE|UF|PR|NR|SD| OS | 



|AB 



RESERVED | MESSAGE TO INP TYPE 
REQUEST IDENTIFIER (glOQP) 



PARAMETER 1 (QMISC) 
OUT COUNT 



PARAMETER 2 (QPAR2) 
SEND DIALOGUE COUNTER 



RECEIVE DIALOGUE COUNTER 
"MESSAGE SENT" EOT BUFFER 



DFLAG 

DLINK 

DIOQP 

DLDEV 

DDLTP 

DILTP 

DSTATUS 

DTRLX 

DTIME 

READYQ 

READYQTL 

ACTIVEQ 

ACTIVEQTL 

WAITEDQ 

DSTATE 

DOUTMSG 

DOUTID 

DOUTP1 

DOUTCNT 

DOUTP2 

DSEND 

DRECV 

DEOT 
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INP DIT (cont) 



2U 

25 
26 

27 
28 

29 
30 
31 
32 
33 
3U 

35 
36 
37 



RESERVED 



| MESSAGE FROM INP TYPE | 



REQUEST IDENTIFIER (@IOQP) 
ERROR CODE |LS| I CSTATUS 



IN COUNT 
TRANSMISSION LOG 



PARAMETER 



TRACE READY REQUESTS COUNT 



EXTERNAL TRACE EXTRA DATA SEGMENT NUMBER 



RESERVED 



! OUT MSG TYPE AT ERROR 



REQUEST IDENTIFIER (glOQP) 



PARAMETER 1 (QMISC) 



OUT COUNT 



PARAMETER 2 (QPAR2) 



LAST CS ERROR CODE 



38 | IOQP POINTER AT TIME OF ERROR 

39 JTPIPHY DRVR VERSN # ! LOGICAL DRIVER VERSION # 



kO ! RESERVED ! IN MSG TYPE AT ERROR 
Ul 1 REQUEST IDENTIFIER (@IOQP) 



k2 ! ERROR CODE !LS! 
U3 ! IN COUNT 



! STATUS 



kk 1 

h5 i 



TRANSMISSION LOG 
PARAMETER 



U6 ! 

1*7 ! 



DRIVER ERROR CODE 
MONITOR ERROR CODE 



DINMSG 
DINID 
DRSTATUS 
DINCNT 
DXLOG 
DINPARM 
DTRCNT 
DDSTN 
DERROR 



DCSERR 
DSAVE 
DVERSION 
DERRORI 



DDRVRERR 
DMNTRERR 
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INP DIT (cont) 



kS ! HARDWARE ERROR STATUS ! SIO PROGRAM INDEX ! DSERR 

U9 ! TOOTHPICK HARDWARE ERROR STATUS ! DTP' ERROR 

50 | ADDITIONAL TOOTHPICK HARDWARE ERROR STATUS | 

51 ! DRIVER TRACE READ IOQ POINTER ! DTR'IOQP 

DFLAG - Flags, IOSTATE and MAMSTATE 

ACTIVE - If set, the Driver is active servicing this device 

REQUEST - If set, service for this device was requested while 
the Driver was active. The Driver is run again to 
insure servicing of the condition which caused 
REQUEST to be set. 

DO'TIMING - If set, the hardware and software timers are started 
in the normal manner when performing an operation. 
If clear, no timing is done. 

SIOPREEMPT- Preemptive request queued by ATTACHIO. Not used by 
this Driver. 

IOPROG - If set, an I/O program is in progress. Set by 
STARTIO and cleared by GIP. Not used by the 
Driver. 

IAK - Interrupt Acknowledge If set, an interrupt has 
occurred or a software timeout has completed. 

SIMULATOR - If set, all I/O is to be simulated. The Driver will 
set flags in the DRT instead of calling STARTIO. 

MAMSTATE - Memory Manager State 

- Null, no Memory Management requests or condition 

1 - Not used 

2 - Data segment associated with the first request in 

the Active Queue is being made present and frozen. 

3 - Data segment associated with the first request in 

the Active Queue is frozen in memory. 
U - Data segment associated with the second re- 
quest in the Active Queue is being made pre- 
sent and frozen. Implies the data segment 
associated with the first request is frozen. 

5 - Data segments associated with the first and 

second requests on the Active Queue are frozen 
in memory. 

6 - Not used 

7 - Not used 
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INP DIT (cont) 



EOSTATE - Current I/O program operation being performed 

- Inactive No I/O in progress 

1 - Idle Read The Idle Read I/O program has been 

started. 

2 - Sending message An I/O program which sends a 

message without data and then goes to the Idle 
Read section of the I/O program has been started. 

3 - Sending data An I/O program which sends a 

message and data and then goes to the Idle Read 
section has been started. 
It - Send message and interrupt An I/O program 

which sends a message without data then interrupts 
and halts when the message is sent has been 
started. 

5 - Send data and interrupt An I/O program which 

sends a message with data then interrupts and 
halts has been started. 

6 - Receive data An I/O program which sends a 

message and receives data then interrupts and 
halts has been started. 

7 - Do not start I/O Used to hold off requesting 

any I/O activity during a power on reset or 
when an error occurs. 



DLINK - Link word for the linked list of devices waiting to be 
serviced by the I/O process associated with this device 



DIOQP - System DB relative pointer to the first element in the 
requests to be processed list for this device The re- 
quests are queued to this list by ATTACH! but in pro- 
cessing, the are moved to other queues depending of the 
state of the request The Driver always attempts to 
keep this list empty. 



DLDEV - Logical Device Number of this device 

DDLTP - System DB relative pointer to the Driver Linkage Table. (DLT) 

DILTP - System DB relative pointer to the Interrupt Linkage Table. (ILT) 



DSTATUS - Controller hardware status Set by GIP on interrupt and 
the Physical Driver during certain service operations 
See INP ERS for description. For the Toothpick ver- 
sion, this word contains the software timeout flags 
as described for the word DTIME below. 
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INP DIT (CONT) 



DTRLX - Timer request index for software timeouts as returned by 
the MPE procedure TIMEREQ 



DTIME - Timed out flags and type 3 driver process PCB Number 
TIMED - If set, a software timeout has completed 



READYQ - System DB relative pointer to the IOQ for the first request 
in the Ready Queue. If zero, the Ready Queue is empty. 

READYQTL - System DB relative pointer to the last IOQ in the 
Ready Queue. When the queue is empty, this word 
points to the word preceding the queue head pointer 
in the DIT. 



ACTIVEQ - System DB relative pointer to the IOQ for the first 

request in the Active Queue. If zero, the Active Queue 
is empty. 



ACTIVEQTL - System DB relative pointer to the last IOQ in the 
Active Queue. When the queue is empty, this word 
points to the word preceding then queue head pointer 
in the DIT. 



WAITEDQ - System DB relative pointer to the IOQ for the first 

request in the Waited Queue. If zero, the Waited Queue 
is empty. 



WAITEDQTL - System DB relative pointer to the last IOQ in the 
Waited Queue. When the queue is empty, this word 
points to the word preceding then queue head pointer 
in the DIT. 



DSTATE - Driver state and control flags 
ERRORONLY - If set, the Driver trace record is to be returned to 
the Trace Process only when an error occurs. 



WRAP 



TRACEON 



If set, the Driver will overlay the oldest trace 
entry when a trace record overflow occurs. If 
clear, entries are lost when an overflow occurs. 
If set the Driver trace facility is enabled and the 
Driver generates trace entries for most of its local 
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INP DIT (CONT) 
subroutine calls. 

PFSTATE - Power failure recovery state 

- No power failure recovery in progress 

1 - Powerfailure detected on the mainframe before 

INP indication. Check for completion of any 
pending I/O and then wait in PFSTATE 2 for INP 
to pfail. 

2 - Power failure detected on the Mainframe before 

INP has indicated a power failure. Wait for 
INP to indicate a power failure. 

3 - Power failure indicated by INP before being 

informed by the Mainframe power failure rou- 
tines. Wait for the Mainframe power failed re- 
quest. 
U - Power failure indicated both on the Mainframe 
and by INP. Power failure recovery may be star- 
ted. 

5 - Send Redo The Mainframe receive count was less 

than INP's send count so the dialogue must be 
restarted. The Driver is sending the Redo mes- 
sage. 

6 - Send Ignore The Mainframe send count was 

greater than INP's receive count so any part of 
a dialogue so far received is to be ignored and 
the entire dialogue will retransmitted. The 
Driver is sending Ignore message. 

7 - Recovered. The Mainframe and INP dialogue 

counters agree or mainframe not sending, so no 
recovery is necessary. The Driver is sending 
the recovered message informing INP to go back 
to its normal mode. 

UNFRZ - If set, the source data segment is to be unfrozen 
when the data has been transmitted to the INP. If 
clear, the source data segment remains frozen until 
a reuquest complete indication is returned by the 
INP. 






FA5SKEADS - II' set, xnen react requests are to De passeu aiouuu 
other requests which have been impeded because no 
buffers are available on the INP. 

NOTRDYWAlT- If set, then a request has been impeded because no 
buffers were available on the INP. 

SENDING - If set, an I/O program which send sends a message, 

with or without associated data has been started but 
not completed. 

OPENSTATE - Operational state of the Driver and INP 
- Not opened or closed 
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INP DIT (CONT) 



1 - In ROM The device has been opened but the RAM 

Operating System has not been entered 

2 - Crashed Some catastrophic error has occured 

3 - In RAM. The device has been opened, down 

loaded and is in the RAM Operating System. 



ABORT - If set one or more requests have been aborted but 
the abort was not done because the aborted request 
was in the process of doing a Memory Management 
function or I/O when when request to abort was pro- 
cessed. The actual abort will take place when the 
Memory Management function completes. 

The following five words hold the message block which is sent to 
INP when the Physical Driver is called to send a message with or 
without associated data. The Logical Driver sets the message 
contents into this area and calls the Physical Driver to send the 
message. 



DOUTMSG - Message type code for messages sent to INP 

DOUTID - Request identifier associated with the message being 
sent. 

D0UTP1 - Parameter one of the message being sent to INP 

DOUTCNT - Count parameter of the message being sent to INP 

D0UTP2 - Parameter two of the message being sent to INP 



DSEND - Messages sent counter. This word contains the number of 
messages sent since the RAM Operating System was entered. 
It is used for power failure recovery. 



DRECV - Messages received counter. This word contains the number 
of messages received from INP since the RAM Operating 
System was entered. It is used for power failure re- 
covery . 



DEOT - End of dialogue flag. When a message has been sent and 

the EOT indicating INP has received the message is trans- 
mitted, it is received into this word. This flag is used 
to indicate to the Logical Driver that a transmission has 
been completed and that the Physical Driver should be 
called to check the completion status and update the 
IOSTATE. 
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INP DIT (CONT) 



The following six words are the data area into which messages 
from INP are received. The Physical Driver constructs I/O pro- 
grams which reference this area. 

DINMSG - Message type code of message from INP 

DINID - Request Identifier associated with message from INP 

DRSTATUS - Request Completion status 

DINCNT - Number of bytes of data to be received associated with 
the completion of a request which results in data be- 
ing sent from INP. 

DXLOG - Transmission log to be returned when the request 
identified by DINID is completed. 

DINPARM - Parameter associated with the completion of this 

request. This word is return in the X register by 
IOSTATUSX. 



DTRCNT - 'Trace ready pending count. This word contains the 

number of Trace Ready messages recieved but not satis- 
fied by Trace Read requests. 



DDSTN - If not zero then internal Driver extra data segment 

tracing is enabled and this is the data segment number 
into which the trace entries are to be set. 



DERROR - Driver Error block. The following sixteen words are 

used to store information describing the current opera- 
tions being performed when a catastrophic Driver error 
occurred. A catastrophic error occurres on illogical 
Driver control data, MPE errors or when INP does not 
respond in an expected manner. The first five word 
block is used to hold tue current or x5.3o message «rans~ 
mitted to INP when a catastrophic error condition was 
detected. It contains the data in the same format as 
message to INP block. 



DCSERR - CS Error Code associated with a catastrophic Driver 
error 



DSAVE - Request Identifier of the request being processed when a 
catastrophic Driver error was detected 
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INP DIT (CONT) 



DVERSION - Version numbers of the Physical and Logical Drivers 

TP - If set, the Physical Driver is for the Toothpick 
System 

PVERSION - Physical Driver version number 

LVERSION - Logical Driver version number 

DERR0R1 - The six word block beginning here is used to hold the 
last message received from INP before a catastrophic 
Driver error was detected. It contains the data in the 
same format as the message from INP block. 

DDRVRERR - Holds the code specifying the catastrophic error 

detected by the Physical Driver. See ERRORS under the 
PHYSICAL DRIVER INTERNAL SPECIFICATIONS for the def- 
inition. 

DMNTRERR - Holds the code specifying the catastrophic error 

detected by the Logical Driver. See ERRORS under the 
LOGICAL DRIVER INTERNAL SPECIFICATIONS for the def- 
inition. 

DSERR - Hardware Controller status when a catastrophic Driver 
error was detected. 

HSTATUS - Left byte of the DSTATUS word at time of error 

SIOPX - SIO program area relative index to the last order 

executed or current order being executed at time of 
error . 

DTP 'ERROR - Toothpick hardware error status. To be defined. 

DTR'IOQP - If not zero then an IOQP pointer to the Trace Read 

request which is supplying the locked and frozen buf- 
fer into which the Driver places trace entries to gen- 
erate a trace record. 

DLOGX - Driver local trace buffer index. This is the index 

relative to the Driver local trace buffer to place the 
next trace entry. 

DLOGBUF - Driver local trace buffer. This buffer extends from 
here to the end of the DIT. 
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DISC REQUEST TABLE AND DISC REQUESTS 



Requests for disc transfers are effected by acquiring an entry from the Dis 
Request Table (DISCREQTAB), filling the proper information, and calling the 
DISCQMANAGER to link the request into the device's doubly linked request qu 
The head and tail of a device's request queue are contained in the 
devices' s DIT. 



DISCREQTAB 



I I 
| DIT | 

I I 



+- 

I 
-+ 



• >+ 



+ 



+ — > 



Device ' s 

Current 

Request 



First 

Request 

in Queue 



Next 
Request 
in Queue 



Last 
Request 



<> + 



I 
<> + 

<> + 

I 

1 

■ 

I 
<> + 
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DISC REQUEST TABLE 

DISCREQTAB DST ENTRY* = 56 (%70) 
DISCREQTAB PRT = &L031 



DISCREQTABOO 
DISCREQTABOl 
DISCREQTAB02 
DISCREQTAB03 
DISCREQTABOU 
DISCREQTAB05 
DISCREQTAB06 
DISCREQTAB07 
DISCREQTAB08 
DISCREQTAB09 
DISCREQTABIO 

DISCREQTAB15 



DISC REQUEST TABLE ENTRY FORMAT 
1 2 3 h 5 6 7 8 9 10 11 12 13 lU 15 



I--I--I--I--I--I--I--I--I--I--I--I 



TOTAL ENTRIES | PRIMARY ENTRIES 
IMPEDED PROCESS PCB | ENTRY SIZE (%20) 



TABLE INDEX OF HEAD OF AVAILABLE ENTRY LIST 
TABLE INDEX OF TAIL OF AVAILABLE ENTRY LIST 



MAX ENTRIES IN USE | CURRENT ENTRIES IN USE 
OVERFLOWS 



TOTAL REQUESTS 



SYSBASE INDEX OF HEAD OF DISABLED REQ Q 



SYSBASE INDEX OF TAIL OF DISABLED REQ Q 
IIIIIIIIIIIUIUHIIIIIIIIUUIIIIIIUIIIIIIIU 



iiiiiiiiuiiiiiiiuiiiiiiiiiiiiiiiiiliiiiniin 



DISCQHEAD 
DISCQTAIL 
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DISC REQUEST ELEMENT FORMAT 



Word 00 



Word 01 
Word 02 
Word 03 
Word 0U 

Word 05 

Word 06 
Word 07 
Word 08 
Word 09 
Word 10 
Word 11 
Word 12 
Word 13 
Word lU 
Word 15 



1 2 3 4 5 6 7 8 9 10 11 12 13 lU 15 

I 



S U 
B |0 
U |W 
F |A 
IK 
IE 



P |C 
F |U 
A JR 

I IR 
L |E 

IQ 



REQUEST URGENCY CLASS 



UNIT # 



LDEV f 



S| 



MISCELLANEOUS 
DST (IF PROCESS DISC I/O) 



BANK (IF SEGMENT TRANSFER) 
OFFSET INTO DATA SEG (IF PROCESS DISC I/O) 



ADDRESS IN BANK (IF SEGMENT TRANSFER) 

| FUNCTION 



COUNT/XLOG/CONTROL RETURNS 
PI (HODA IF SEGMENT TRANSFER 



P2 (LODA IF SEGMENT TRANSFER 
PCBN | QUALIFIER | STATUS 



SYSBASE RELATIVE INDEX OF PREV REQUEST IN QUEUE 
SYSBASE RELATIVE INDEX OF NEXT REQUEST IN QUEUE 



SEGIDENTIFIER (IF SEG TRANSFER) 
DISPLACEMENT OF READ OR WRITE FROM SEG BASE (MM) 



/////////////////////////////////////////////// 
/////////////////////////////////////////////// 
/////////////////////////////////////////////// 
/////////////////////////////////////////////// 



URGCLASS 

LDEVN 

MISC 

DSTN 
S=STACK 

ADDR 

FUNC 

XFERCNT 

PARI 

PAR2 

STAT 

PREVREQP 

NEXTREQP 
SEGIDENT 
SEGDISP 

AUXREQFLAGS 



Note: Upon return to free list, word (#1) becomes index of next EE 
free entry. 
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Word 


- QFLAG - Req 


Bit 


.ABORT 


Bit 1 


.MMREQ 


Bit 2 


.DIAG 


Bit 3 


.SBUF 


Bit U 


.IOWAKE 


Bit 5 


.BLOCKED 


Bit 6 


. COMPLETED 



Request has been aborted externally. 

Request is for a segment transfer. 

Diagnostic request (not used) . 

System Buffer. Target is a system buffer 
whose index is relative to the start of 
the SBUF table. 

Wake caller on completion of request. 

Blocked I/O. Caller is waited in ATTACHIO until 
request is completed. 

Request has been completed and caller woken if 
he had specified. 



Data segment has been made present and is 
frozen. 

MAM error on data segment make present. 

PREQQUEUED Request is queued into disc's req queue 

Start SIO failure in GIP. 

The I/O has been aborted because of a powerfail. 

Request is device's current request. 

Request is disabled. 

Attempted to disable this request. 

A message request reply has completed. 

Word 2 - QLDEV.QLDEVN - Logical Device Number 
Word 3 - C$ISC - Device dependent. 

Word U 

QDSTN - If SYSBUFRs is clear then this is the DST number of the target 
data segment. If bit is set then buffer address is a DB offset 
value instead of segment relative offset (implemented for 
NOWAIT 10 and NOBUFF). 

Word 5 

QADDR - Offset in data segment or sys buff table to target data buffer. 

Word 6 

QFUNC.FUNC - Function code and qualifiers as specified by driver. 



Bit 7 


.DATAFRZN 


Bit 8 


.MAMERRORD 


Bit 9 


.PREQQUEUE1 


Bit 10 


.SFAIL 


Bit 11 


.PFAIL 


Bit 12 


•CURREQ 


Bit 13 


.DISABLED 


Bit lit 


.DISATMPT 


Bit 15 


.MSGDONE 



13-7U 



Word 7 

QXFERCNT-On initiation specifies the word count if positive or byte 

count if negative. At completion of the request this location 
contains the actual transmission count in the same units as the 
call. Certain control requests return data through this 
location. 
Word 8 

QPAR1 - Parameter one, defined by driver 
Word 9 

QPAR2 - Parameter two, defined by driver 

QMISC - Miscellaneous request dependent storage available to driver. 
Word 10 
QSTAT.PCBN - PCB Number of process which made this request. Zero if 

not associated with any process and IOQ is to be returned 
by the system. 
.QUALIFIER - A code which further defies or qualifies the 

general status. Defined by driver. 
•STATUS - General Status. Indicates current and result state of 
the request according to the following codes. 

- not started or awaiting completion. 

1 - successful completion. 

2 - end of file detected. 

3 - unusual condition. 

U - irrecoverable error. 

NOTE: See I/O System Status Returns. 
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IOQ TABLE LAYOUT 



TOTAL # | PRIMARY # 

IMPEDED | ENTRY SIZE 
PROCESS PCB J 

HEAD INDEX 

TAIL INDEX 



MAXIMUM OF | CURRENT 
IN USE 1 IN USE 



OVERFLOWS 



TOTAL REQUESTS 



INDEX OF 5 



ENTRY 1 



ENTRY 2 



INDEX OF 1 



ENTRY 3 



TSIZE 
THEAD 
TTAIL 
TUSE 

TOVRFL 

TRQSTS 
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IOQ (CONT.) 



Indeterminate 



ENTRY k 
(IN USE) 



INDEX OF 2 



ENTRY 5 
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1 

2 
3 
k 

5 
6 
7 
8 

9 
10 



IOQ ELEMENT 
1 2 3 h 5 6 7 8 9 10 11 12 13 l 1 * 15 

__l__l„l__l__l_-l--l--l--l--l__l-l--l-l--l- 

REQUEST DEPENDENT FLAGS 

IOQ POINTER 
UNIT # | QLDEVN 
MISCELLANEOUS 
S | DATA SEGMENT DST NUMBER 

ADDRESS 

| FUNCTION 
COUNT/XLOG/CONTROL RETURNS 
PI 
P2 
PCBN | QUALIFIER | STATUS 



QFLAG 

QLINK 

QLDEV 

QMISC 

QDSTN S(Word U(0:l) 
Stackflag If set 
QADDR is DB rel. 

QADDR 

QFUNC 

QWBCT 

QPAR1 

QPAR2 

QSTAT 



QFLAG - Request dependent flags 

Bit .ABORT Request has been aborted externally. 

Bit 1 .SPECIAL Special handling is to be applied to this 

request. For disc, indicates a memory 
management request. 

Bit 2 .DIAG Diagnostic request (not used). 

Bit 3 .SBUF System Buffer. Target is a system buffer 

whose index is relative to the start of 
the SBUF table. 

Bit U .IOWAKE Wake caller on completion of request. 

Bit 5 .BLOCKED Blocked I/O. Caller is waited in ATTACHIO until 

request is completed. 

Bit 6 .COMPLETED Request has been completed and caller woken if 

he had specified. 
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IOQ ELEMENT (CONT. ) 



Bit 7 


.DATAFRZN 


Bit 8 


.MAMERRORD 


Bit 9 


.PREQ 



Bit 10 



Bit 11 



.SFAIL 



.PFAIL 



Bitsl2-13 .PREMPT 



Data segment has been made present and is 
frozen. 

MAM error on data segment make present. 

This request has been started but was preempted 
by a MAM request. 

Start SIO failure in GIP. 

The I/O has been aborted because of a powerfail. 

Premptive type code: 1-soft, 2 -hard. 



Bit 15 .MSGDONE A message request reply has completed. 
QLINK - SYSDB relative pointer to next IOQ element. Points to first 

word of element. 
QLDEV.QLDEVN - Logical Device Number 
QMISC - Device dependent. 

QDSTN - If SYSBUFRs is clear then this is the DST number of the target 
data segment. If bit is set then buffer address is a DB offset 
value instead of segment relative offset (implemented for 
NOWAIT 10 and NOBUFF). 
QADDR - Offset in data segment or sys buff table to target data buffer. 
QFUNC.FDNC - Function code and qualifiers as specified by driver. 
QWBCT - On initiation specifies the word count if positive or byte 

count if negative. At completion of the request this location 
contains the actual transmission count in the same units as the 
call. Certain control requests return data through this 
location. 
QPAR1 - Parameter one, defined by driver 
QPAR2 - Parameter two, defined by driver 

QMISC - Miscellaneous request dependent storage available to driver. 
QSTAT.PCBN - PCB Number of process which made this request. Zero if 

not associated with any process and IOQ is to be returned 
by the system. 
.QUALIFIER - A code which further defies or qualifies the 

general status. Defined by driver. 
.STATUS - General Status. Indicates current and result state of 
the request according to the following codes. 

- not started or awaiting completion. 

1 - successful completion. 

2 - end of file detected. 

3 - unusual condition. 

k - irrecoverable error. 



13-79 



PENDING 



I/O SYSTEM STATUS RETURNS 

STATUS % 



1 - WAITING FOR COMPLETION 10 

2 - DOING ERROR RECOVERY 20 

3 - NOT READY WAIT 30 
U - NO WRITE RING WAIT UO 
5 - NEW PAPER TAPE WAIT 50 



SUCCESSFUL 

- NORMAL 1 

1 - READ TERMINATED WITH SPECIAL CHARACTER 11 

2 - TAPE RETRY FOR SUCCESS REQUIRED 21 

3 - LOW TAPE OR END OF TAPE AFTER WRITE 31 



END OF FILE 

1 - PHYSICAL END OF FILE 12 

2 - DATA 22 

3 - END OF DATA 32 
h - HELLO U2 

5 - BYE 52 

6 - JOB 62 

7 - END OF JOB 72 



3 - UNUSUAL CONDITION 

1 - TERMINAL PARITY ERROR 13 

2 - TERMINAL READ TIMED OUT 23 
3-1/0 ABORTED EXTERNALLY 33 
k - DATA LOST 1*3 

5 - DATA SET NOT READY OR DISCONNECT 53 

OR UNIT NOT ON LINE 

6 - ABORTED BECAUSE OF POWER FAIL 63 

7 - BOT AND BSR, BSF REQUEST 73 

10 - TAPE RUNAWAY 103 

11 - EOT AND WRITE REQUEST 113 

12 - NO WRITE RING AFTER REQUEST TO OPERATOR 123 

13 - END OF TAPE (PAPER TAPE LOW) 133 
Ik - PLOTTER LIMIT SWITCH REACHED lU3 

15 - ENABLE SUBSYSTEM BREAK AND NO CONTROL Y PIN 153 

16 - READ TIME RETURNED OVERFLOW 163 

17 - BREAK STOPPED READ 173 

20 - WRITE AND NO CARD IN WAIT STATION 203 

21 - DEVICE POWERED ON - OPERATING ENVIRONMENT LOST 213 
27 - VFC HAS BEEN RESET 273 
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I/O SYSTEM STATUS RETURNS (CONT.) 



IRRECOVERABLE ERROR 

- INVALID REQUEST k 

1 - TRANSMISSION ERROR Ik 

2 - I/O TIME OUT 2k 

3 - TIMING ERROR 3k 
k - SIO FAILURE kk 

5 - UNIT FAILURE 5U 

6 - INVALID DISC ADDRESS 6k 

7 - TAPE PARITY ERROR jk 

11 - PAPER TAPE TAPE ERROR llU 

12 - SYSTEM ERROR 12U 

13 - INVALID SBUF INDEX 13 1 * 
lit - CHANNEL FAILURE, TIMEOUT OR NO RESPONSE FROM ikk 

CONTROLLER 

15 - UNINITIALIZED MEDIA (LINUS) l$k 

16 - NO SPARE BLOCKS AVAILABLE l6U 

17 - DELETED RECORD DETECTED ON IBM FLOPPY DISC Ijk 

20 - LABELED DEVICE UNAVAILABLE AFTER REELSWITCH 20U 

21 - PARITY ERROR DETECTED ON PHI COMMAND (EPOC) 2lU 
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IOQ ELEMENT FOR 7976A MAGNETIC TAPE 



+ 

0| 

+ 

1 



%10 

Jill 

%12| 

+- 



l 2 3 >i 5 6 7 8 9 10 11 12 13 l 1 * 15 
._+ — +__+__+__+__+__+__+__+__+__+__+__+__+__+__+ 

Request dependent flags (see below) 

SYSDB relative pointer to next IOQ element. 
Points to first word of element. 



Logical device number 



R| B| F| G|B0| T0UT| FSCNTR | BSCNTR | RTCNTR 
._+__+__+ — +--+ + + + + 

S| If QFLAG. (3:1) is clear then this is the 
| DST number of the target data segment. If 
j S is set, QADDR is DB relative. 



5 | Offset in the data segment or system buffer 
table to the target data buffer. 

61 | Function code for 

| this request. (See 
| next section.) 



On initiation, specifies the word count (>0) 
or byte count (<0). At completion of the 
request this location contains the actual 
transmission count in the same units (bytes 
or words) as in the request. 



Parameter 1. Used only for reads. Contains 
the EOF specification in bits (13:3). 



Parameter 2. Used only for writes. If bit 
(13:1) is set, writing past EOT is allowed. 



PCBN 



| QUALIFIER | STATUS | 



MNEMONIC 
QFLAG 
QLINK 

QLDEV 
QMISC 
QDSTN 

QADDR 
QFUNC 

QWBCT 



QPAR1 
QPAR2 
QSTAT 



QFLAG - Request dependent flags 

Bit ABORT - Abort this request and return an error indication 

to the caller. 
Bit 1 SPECIAL - Apply special handling to this request. (Not used) 
Bit 2 DIAG - This is a request from the diagnostic subsystem. 

(Not used) 
Bit 3 SYSBUFF - Target is an index relative to the SBUF Table of 

the data buffer. 
Bit U IOWAKE - Wake caller on completion of request. 
Bit 5 BLOCKED - Blocked I/O. The caller is waited in ATTACHIO 

until the request is completed. Implies IOWAKE. 
Bit 6 COMPLETED - The request has been completed and the caller 
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awakened if he had requested (with IOWAKE). 



Bit 7 DATAFRZN 



Bit 8 MAMERRORD 



Bit 9 PREQ 
Bit 10 SFAIL 



Bit 11 PFAIL 



Set by the memory management routines (MAM) when a 
MAKEPRESENT request is successfully completed and 
indicates the data segment is frozen in memory. 
An error has occurred while MAM was trying to 
make the target data segment present and freeze 
it in memory. 
(Not used) 

Delayed failure of SIO instruction. If a call to 
START 'HPIB resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed when the request was selected 
for execution. 

The request was aborted because of a system power 
failure . 



QMISC - Driver request dependent flags and counters, 
error retries. 



Used mostly for 



RETRY - Indicates an error retry is in progress. 

BACK - Backspace record processing for an error retry is in 

progress. 
FORWARD - Forward space record processing for an error retry is 

in progress. 
GAP - Gap processing for an error retry is in progress. 
BODEOF - Backspace record due to a data EOF processing is in 

progress . 
TOUTCNTR - GIC timed-out counter. 
FSCKTR - Forward space record counter. 
BSCNTR - Backspace record counter. 
RTCNTR - Error retry counter. 



QSTAT - PCB number and request completion status. 



PCBN 



STATUS 



QUALIFIER 



The Process Control Block (PCB) number of the process 
which made this request. If zero, the request is not 
associated with any process and the IOQ element is to 
be returned by the system when the request has completed. 
General status indicating the final state of the request. 
The following codes are used: 

- Not started or awaiting completion. 

1 - Successful completion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 
k - Irrecoverable error has occurred. 

- A code which further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 
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SERIES II/III LINE PRINTER IOQ ELEMENT 



l 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
+--+--+--+--+--+--+ — +--+__+__+ — +__ + __+__ + __ + __ + 

0| Request dependent flags (see below) | 
+ — +--+--+ — +--+--+--+-_+--+--+_-+__+ +__+__+ 

SYSDB relative pointer to next IOQ element. 

Points to first word of element. 
+ + 

2 | Physical unit number | Logical device number 
+--+ + +__+__+__+__+ 

31 | WAITFLDI |RT|MC|PS|PP 



%10 
%11 
JH2 



.-+ + + +__+__+__+_. 

S| If QFLAG. (3:1) is clear then this is the 
| DST number of the target data segment. If 

I S is set, QADDR is DB relative. 

._+ 



Offset in the data segment or system buffer 
table to the target data buffer. 



Not used 



| Function code for 
| this request. See 
I next section. 



On initiation, specifies the word count (>0) 
or byte count (<0). At completion of the 
request this location contains the actual 
transmission count in the same units (bytes 
or words) as in the request. The count is 
truncated to produce a max of 256 characters. 



Parameter 1 of QFUNC. 


See next 


section. 


Parameter 2 of QFUNC. 


See next 


section. 


PCBN | 


QUALIFIER 


| STATUS 



MNEMONIC 

QFLAG 

QLINK 

QLDEV 
QMISC 
QDSTN 

QADDR 
QFUNC 

QWBCT 



QPAR1 
QPAR2 
QSTAT 



QFLAG 


- Request d 


Bit 


.ABORT 


Bit 1 


.SPECIAL 


Bit 2 


.DIAG 


Bit 3 


.SYSBUFRS 


Bit 1+ 


.IOWAKE 


Bit 5 


. BLOCKED 


Bit 6 


. COMPLETED 



Request has been aborted externally, either by 

the operator or a system intrinsic. 

Not used. 

Not used. 

Target is a system-buffer-relative index to the 

data buffer. * 

Wake caller on completion of request. * 

Blocked I/O. The caller is waited in ATTACHIO 

until the request is completed. Implies IOWAKE. * 

Request has been completed, and the caller 

awakened if s/he had requested (with IOWAKE). * 
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Bit 7 -DATAFRZN 



Bit 8 .MAMERRORD 



Bit 9 .PREQ 
Bit 10 .SFAIL 



Bit 11 .PFAIL 

Bitsl2-13 .PREMPT 

Bit lU . 

Bit 15 .MSGDONE 



If set, then the data segment has been made 

present and frozen in memory. Set by the memory 

management routines (HAM) when a MAKEPRESENT 

request is successfully completed. * 

An error has occurred while MAM was trying to 

make the target data segment present and freeze 

it in memory. * 

Not used. 

Delayed failure of SIO instruction. If a call to 

STARTIO resulted in the request being added to 

the channel queue, this bit indicates that the 

SIO instruction failed when the request was 

selected for execution. 

The request was aborted because of a system power 

failure. 

Not used. 

Not used. 

Not used. 



QMISC.WAITFLD - This field contains a code describing the current 
idle state of the driver. The driver orients itself 
at each entry, based on the state of this field. 

- The current entry is the start of a new request. 

1 - The normal state while waiting for a completion 

interrupt of a print, fill or control operation. 

2 - An SIO channel program was in progress when 

an asynchronous interrupt (usually an exter- 
nal abort) occurred, or a 2607 printer was 
placed on-line after going off-line while 
printing. The driver enters this state and 
waits for three seconds for the channel pro- 
gram or 2607 printer to complete, so as not 
to pose control conflicts to the U.I. card 
between the driver and the program. 

3 - A Not Ready, Off Line or Paper Out (or Jammed) 

condition has been detected. The request will be 
continued or retried when the operator has 
corrected the condition and placed the printer on 
line. 
U - A 2607 (Tally) printer has come on-line af- 
ter going off-line while printing. One line 
of data is buffered in the printer. This 
state causes the driver to shift to state 2 
to allow the 2607 to print and space the 
buffered line before sending it the next 
line. 

RETRY (RT). Kludge to catch an LDEV configured as a 

2608 when the physical device is a different subtype. 

Prevents Master Clear 'ing and retrying a request more 

than once when the Power Fail/Reset device status bit 

is "set" by a non-2608. 
QMISC.(13:1) - MASTER 'CLEAR (MC). Set when a 2608 Master Reset, 

required because of a printer Power Fail/Reset, is 

configured and executed, 
QMISC.(ll»:l) - PRESPACE (PS). The current operation is a pre- 



QMISC.(12:1) 
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QMISC.(15:1) 



QSTAT.PCBN 



QSTAT. STATUS 



QSTAT. QUALIFIER - A 



space (space then print) request. This bit a- 
lerts the continuation section to fill the 
print buffer after spacing. 

- PRE *T0' POST (PP). The previous request was a prespace 
operation while the current operation is a postspace. 

- The Process Control Block (PCB) number of the process 
which made this request. If zero, the request is not 
associated with any process, and the IOQ element is 
to be returned by the system when the request has 
completed. * 

- General status. Indicates the final state of the 
request. The following codes are used: 

- Not started, or awaiting completion. 

1 - Successful completion. 

2 - Not used. 

3 - Unusual, but recoverable, condition (such as 

Request Aborted Externally) . 
k - Irrecoverable error (such as SIO failure, 
memory parity error, etc.). 
code which further defines or qualifies the 



general status. 
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2608 LINE PRINTER IOQ ELEMENT -- HPIB SYSTEMS 



1 2 3 1; 5 6 7 8 9 10 11 12 13 lU 15 
0| Request dependent flags (see below) 



%10 



%11 



%12| 



SYSDB relative pointer to next IOQ element. 
Points to first word of element. 



— + 



| Logical device number 



PP|PE|MC|TOUTCNTR| 



WAITCODE 



S| If QFLAG.(3:1) is clear then this is the 
j DST number of the target data segment. If 
| S is set, QADDR is DB relative. 



Offset in the data segment or system buffer 
table to the target data buffer. 



j Function code for 
j this request. (See 
j next section.) 



On initiation, specifies the word count (>0) 
or byte count (<0). At completion of the 
request this location contains the actual 
transmission count in the same units (bytes 
or words) as in the request. 



Parameter 1. Vertical Format specification, 
(See next section for detail. ) 



Parameter 2. Space Mode Flags. (See next 
section for details . ) 



PCBN 



| QUALIFIER | STATUS | 



MNEMONIC 
QFLAG 
QLINK 

QLDEV 
QMISC 
QDSTN 

QADDR 
QFUNC 

QWBCT 



QPAR1 
QPAR2 
QSTAT 



QFLAG - Request dependent flags 



• Abort this request and return an error indication 
to the caller. 

• Apply special handling to this request. (Not used) 

• This is a request from the diagnostic subsystem. 
(Not used) 

- Target is an index relative to the SBUF Table of 
the data buffer. 

• Wake caller on completion of request. 

• Blocked I/O. The caller is waited in ATTACHIO 
until the request is completed. Implies IOWAKE. 

Bit 6 COMPLETED - The request has been completed and the caller 



Bit ABORT 

Bit 1 SPECIAL 

Bit 2 DIAG 

Bit 3 SYSBUFF 

Bit k IOWAKE 

Bit 5 BLOCKED 
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Bit 7 DATAFRZN - 



awakened if he had requested (with IOWAKE). 
Set by the memory management routines (MAM) when a 
MAKEPRESENT request is successfully completed and 
indicates the data segment is frozen in memory. 
Bit 8 MAMERRORD - An error has occurred while MAM was trying to 

make the target data segment present and freeze 
it in memory. 

- (Not used) 

- Delayed failure of SIO instruction. If a call to 
STARTIO resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed when the request was selected 
for execution. 

- The request was aborted because of a system power 
failure. 



Bit 

Bit 



9 PREQ 

10 SFAIL 



Bit 11 PFAIL 



QMISC - Driver request dependent flags and counters. 



PRE 'TO 'POST 

PEJECT 

MASTERCLR 

TOUTCNTR 
WAITCODE 



Pre to post spacing change flag. 

Last operation was a page eject. 

Master clear done to clear powerfail bit in status. 

Master clear needs to be done from not ready ccnditon. 

Channel time-out retry counter. 

Indicates type of wait: 

- new request 

1 - completion wait 

2 - not ready wait 



QSTAT - PCB number and request completion status. 

PCBN - The Process Control Block (PCB) number of the process 
which made this request. If zero, the request is not 
associated with any process and the IOQ element is to 
be returned by the system when the request has completed. 

STATUS - General status indicating the final state of the request. 
The following codes are used: 

- Not started or awaiting completion. 

1 - Successful completion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 
h - Irrecoverable error has occurred. 

QUALIFIER - A code which further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 



13-88 



Operation Function 
WRITE 1 



FILE OPEN 2 

FILE CLOSE 3 

DEVICE CLOSE U 

READ STATUS %17 



2608 Line Printer Request Codes 



Parameters 

PI - Vertical Format Specification 

1 - use 1st data char as format spec 

%53 - " + " » print and suppress spacing 

%55 - "-", print and triple space 

Jt60 - "0", print and double space 

%6l - "1", print and top of form 

%200-%277, print and space N-%200 lines 
%300-%377, print with channel N-%277 

All others, print and single space. 

P2 - Space Mode Flags 

(15:1) - Prespace flag 

if set, print then fill buffer 
if clear, fill buffer then print 
(lU:l) - No page stepover flag 
if set, single and double space 

without stepover (66 lines/page) 
if clear, single and double space 
with stepover (60 lines /page) 

Page eject if not at top of form 

Page eject if not at top of form 

Page eject if not at top of form 

Read I/O status 

Count - buffer must be at least 2 bytes 



VFC SET %100 Load VFC RAM 

Count - form length in words 

(0 loads RAM form internal ROM) 
PI - 6 for 6 LPI or 8 for 8 LPI 

any other value defaults to 6 LPI 

TAB SET %101 Sets logical column definition 

PI - to 15, any other value defaults to 15 
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CIPER IOQ Element 



Word # 


1 

2 

3 
k 

5 
6 



8 

9 
10 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 



Request dependent flags (see below) 
J 1 1 1 I I I i ' i i i i i 



SYSDB relative pointer to next IOQ element. 
Points to first word of element. 



Logical device number 



If QFLAG. (3:1) is clear then this is the 
DST number of the target data segment. If 
S is set, QADDR is DB relative. 



Offset in the data segment or system buffer 
table to the target data buffer. 



Used by the new Disc 
routines for special 
status returns. 



Function code for 
this request. (See 
next section. ) 



On initiation, specifies the word count (0) 
or byte count (<0). At completion of the 
request this location contains the actual 
transmission count in the same units (bytes 
or words) as in the request. 



Parameter 1. 



Parameter 2. 



PCBN 



QUALIFIER 



RSTATUS 



MNEMONIC 



QFLAG 
QLINK 

QLDEV 
QMISC 
QDSTN 

QADDR 
QFUNC 

QWBCT 



QPAR1 
QPAR2 
QSTAT 



QFLAG - Request dependent flags 



Bit ABORT 

Bit 1 SPECIAL 

Bit 2 DIAG 

Bit 3 SYSBUFF 

Bit It IOWAKE 



- Abort this request and return an error indication 
to the caller. 

- Apply special handling to this request. (Not used) 

- This is a request from the diagnostic subsystem. 

- Target is an index relative to the SBUF Table of 
the data buffer. 

- Wake caller on completion of request. 



Bit 5 BLOCKED - Blocked I/O. The caller is waited in ATTACHIO 

until the request is completed. Implies IOWAKE. 
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Bit 6 COMPLETED - The request has been completed and the caller 

awakened if he had requested (with IOWAKE). 



Bit 7 DATAFRZN 



Set by the memory management routines (MAM) when a 
MAKEPRESENT request is successfully completed and 
indicates the data segment is frozen in memory. 



Bit 8 MAMERRORD - An error has occurred while MAM was trying to 

make the target data segment present and freeze 
it in memory. 



Bit 9 PREQ 
Bit 10 SFAIL 



(Not used) 

Delayed failure of SIO instruction. If a call to 
STARTIO resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed when the request was selected 
for execution. 



Bit 11 PFAIL 



- The request was aborted because of a system power 
failure . 



QSTAT - PCB number and request completion status. 



PCBN 



RSTATUS 



QUALIFIER 



The Process Control Block (PCB) number of the process 
which made this request. If zero, the request is not 
associated with any process and the IOQ element is to 
be returned by the system when the request has completed. 

General status indicating the final state of the request. 
The following codes are used: 

- Not started or awaiting completion. 

1 - Successful completion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 
U - Irrecoverable error has occurred. 

A code which further defines or qualifies the general 
status . 



ueuciajL oiiauus \j-j.j/ 



- Pending 

1 - Successful 

2 - End of File 

3 - Unusual Condition 



Anal j ^triMv C+-9-4>ii0 ( & * K I 



1 - Waiting For Completion 
3 - Not Ready Wait 

- No Errors 

(Not Used) 

3 - Request Aborted 

6 - Powerfail Abort 

%21 - Device Powered Up 



fhro^an (RtR\ 



JfcLO 
%30 

%1 



%33 

%63 

%213 
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k - Irrecoverable Error - Invalid Request %h 

1 - Transfer Error %lk 

2 - I/O Timed Out Before Complete %2U 
U - SIO Failure %Uk 
5 - Unit Failure %5U 

%12 - System Error %12U 

%lk - Channel Failure %lkk 

%21 - Parity Error %2lU 
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2619A AND 2631 LINE PRINTER IOQ ELEMENT -- HPIB SYSTEMS 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
+__+ — +--+ — + — + — + — + — + — +--+--+ — + — + — +--+ — + 
0| Request dependent flags (see below) | 



SYSDB relative pointer to next IOQ element. 
Points to first word of element. 



%10 



%H 



5112 1 



I Logical device number 



PP|PE|PF|TOUTCNTR| 



I WAITCODE 



S| If QFLAG. (3:1) is clear then this is the 
I DST number of the target data segment. If 
I S is set, QADDR is DB relative. 



Offset in the data segment or system buffer 
table to the target data buffer. 



I Function code for 
I this request. (See 
I next section.) 



On initiation, specifies the word count (>0) 
or byte count (<0). At completion of the 
request this location contains the actual 
transmission count in the same units (bytes 
or words) as in the request. 



Parameter 1. Vertical Format specification. 
(See next section for detail.) 



Parameter 2. Space Mode Flags. (See next 
section for details.) 



MNEMONIC 
QFLAG 
QLINK 

QLDEV 
QMISC 
QDSTN 

QADDR 
QFUNC 

QWBCT 



PCBN 



I QUALIFIER I STATUS | 
.+ + + 



QPAR1 
QPAR2 
QSTAT 



QFLAG - Request dependent flags 



Bit ABORT 

Bit 1 SPECIAL 

Bit 2 DIAG 

Bit 3 SYSBUFF 

Bit U IOWAKE 

Bit 5 BLOCKED 



- Abort this request and return an error indication 
to the caller . 

- Apply special handling to this request. (Not used) 

- This is a request from the diagnostic subsystem. 
(Not used) 

- Target is an index relative to the SBUF Table of 
the data buffer. 

- Wake caller on completion of request. 

- Blocked I/O. The caller is waited in ATTACHIO 
until the request is completed. Implies IOWAKE. 



Bit 6 COMPLETED - The request has been completed and the caller 
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Bit 7 DATAFRZN 



Bit 8 MAMERRORD 



Bit 9 PREQ 
Bit 10 SFAIL 



Bit 11 PFAIL 



awakened if he had requested (with 10 WAKE) . 

- Set by the memory management routines (HAH) when a 
MAKEPRESENT request is successfully completed and 
indicates the data segment is frozen in memory. 

- An error has occurred while HAM was trying to 
make the target data segment present and freeze 
it in memory. 

- (Not used) 

- Delayed failure of SIO instruction. If a call to 
STARTIO resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed when the request was selected 
for execution. 

- The request was aborted because of a system power 
failure. 



QHISC - Driver request dependent flags and counters for 2631. 

PRE 'TO' POST - Pre to post spacing change flag. 

PEJECT - Last operation was a page eject. 

TOUTCNTR - Channel time-out retry counter, 

POWERFAIL - Power fail flag indicates power fail occurred. 

WAITCODE - Indicates type of wait: 

- new request 

1 - completion wait 

2 - not ready wait 



Format for 2619A 
1 2 3 ^ 



12 



15 



|PP|PE|PF|T0|BF| 



I WAITCODE I 



TOUT - Channel timed out flag 

BUF'FILL - Buffer fill operation in progress 

QSTAT - PCB number and request completion status. 

PCBN - The Process Control Block (PCB) number of the process 
which made this request. If zero, the request is not 
associated with any process and the IOQ element is to 
be returned by the system when the request has completed. 

STATUS - General status indicating the final state of the request. 
The following codes are used: 

- Not started or awaiting completion. 

1 - Successful completion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 
U - Irrecoverable error has occurred. 

QUALIFIER - A code which further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 
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2619 Line Printer Request Codes 



Operation Function 
WRITE 1 



FILE OPEN 2 

FILE CLOSE 3 

DEVICE CLOSE k 

READ STATUS #17 



'IDENTIFY 



#110 



Parameters 

PI - Vertical Format Specification 
1 - Use 1st data char as format 
specification. 

#53 - "+"» print and suppress spacing 

#55 - "-"» print and triple space 

#60 - "0", print and double space 

#6l - "1", print and top of form 

#200 -#277, print and space N-#200 lines 
#300-#312, print with channel N-#277 

#320 - Fill Line Printer Buffer Only 

All others, print and single space. 

P2 - Space Mode Flags 

(15:1) - Prespace flag 

if set, print then fill buffer 
if clear, fill buffer then print 
(lU:l) - No page stepover flag 
if set, single and double space 

without stepover (66 lines/page) 
if clear, single and double space 
with stepover (60 lines/page) 

Page eject if not at top of form 

Page eject if not at top of form 

Page eject if not at top of form 

Read I/O status 

Count - buffer size 

Return ID value in Bank & Buffaddr 



INITIATE 
STATUS 



#111 
#112 



♦LOOPBACK TEST: 
WRT DATA #113 
READ DATA #llU 



Subtest number to execute in Bank and Buffaddr 

(subtest number ranges from to 7) 
Subtest result returned in Bank & Buffaddr 



Data to LP in Bank & Buffaddr [PING] 

Data from LP read into Bank & Buffaddr [PONG] 

Count - Buffer Size (256 bytes max) 
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Operation Function 
WRITE 1 



FILE OPEN 2 

FILE CLOSE 3 

DEVICE CLOSE U 

READ STATUS %17 



2631 Line Printer Request Codes - HPIB 



Parameters 

PI - Vertical Format Specification 
1 - Use 1st data char as format 
specification. 

%53 - "+", print and suppress spacing 

%55 - "-", print and triple space 

%60 - "0", print and double space 

%6l - "1", print and top of form 

%200-%277, print and space N-%200 lines 
%300-fc307, print with channel N-%277 

%320 - Fill Line Printer Buffer Only 

All others, print and single space. 

P2 - Space Mode Flags 

(15:1) - Prespace flag 

if set, print then fill buffer 
if clear, fill buffer then print 
(lU:l) - No page stepover flag 
if set, single and double space 

without stepover (66 lines /page) 
if clear, single and double space 
with stepover (60 lines /page) 

Page eject if not at top of form 

Page eject if not at top of form 

Page eject if not at top of form 

Read I/O status 

Count - 1 byte minumum required 



VFC SET ?il00 LOADS VFC RAM 

PI - 1-1 LPI (lines per inch) 

2 - 2 LPI 

3 - 3 LPI 
k - k LPI 

5 - 5 LPI 

6 - 6 LPI 
8 - 8 LPI 

12 - 12 LPI 

Any other value defaults to 6 LPI, 
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SERIES III CARD READER IOQ 

o l 2 3 U 5 6 7 8 9 10 ll 12 13 l 1 * 15 

0| (SEE BELOW) 

I 

1| IOQP POINTER TO NEXT REQUEST 

I- — " 

2 j UNIT # | LOGICAL DEVICE # 

I 

3| AUXILIARY BUFFER FLAG 

I 

U| DST NUMBER OR 

I 

5| OFFSET IN DST OR BANK 
j 

6| I FUNCTION CODE 
| 

7| WORD(+) OR BYTE(-) COUNT 

I- 

%10| I EOF 

j _____ 

J511 j i BINARY j 

I " - 

%12| PCB NUMBER | QUALIFIER | STATUS 

I 

BITO ABORT 
EXaIL SPEOXAIj 
BIT2 DIAGNOSTIC 
BIT3 SYS BUFFER 
BITU 10 WAKE 
BIT5 BLOCKED 
BIT6 COMPLETED 
BIT7 DATA FREEZE 
BIT8 MAM ERROR 
BIT9 
BIT10 SFAIL 
BIT'll PFAIL 



QFLAGS 

QLINK 

QLDEV 

QMISC 

QDSTN 

QADDR 

QFUNC 

QWBCT 

QPARl 

QPAR2 

QSTAT 
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CARD READER IOQ (CONT.) 



QFLAG - Flags and request state. 



ABORT Abort this request and return an error indication to the 
caller. 

SPECIAL Special handling is to be applied to this request. Has 
no meaning for card reader requests. 

DIAGNOSTIC This is a request from a diagnostic subsystem. Not 
used by card reader driver. 

SYSBUFRS Target is an index relative to the SBUF table of the 
data buffer. 

IOWAKE Wake caller on completion of request. 

BLOCKED Blocked I/O. The caller is waited in ATTACHIO until 
the request is completed. Implies wake. 

COMPLETED Request has been completed and caller woken if requested. 

DATAFRZN If set then the data segment has been frozen in memory. 
Set by MAM when a MAKEPRESENT request is successfully 
completed. 

MAMERRD An error has occurred in trying to make the target data 
segment present and freeze it in core. 

SFAIL SIO program failed to start because a) device didn't 
respond, or b) request has queued because device was 
busy. 

PFAIL This request has been aborted because of a power failure. 

QLINK - SYSDB relative pointer to the next IOQ element. Points to the 
first word of the next element. 

QLDEV - Logical device number. 

QLDEVN Logical device number. 

QMISC - Auxiliary buffer flag. When odd. Data is being read into an 
auxiliary buffer because the requested count is less than 1*0 
words . 

QDSTN - Contains the data segment number of the target data area. 
QADDR - Offset to the target data area in the data segment or bank. 
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CARD READER IOQ (CONT.) 



QFUNC - Function code. See ATTACHIO description for details. 
FUNC Function code field. 
- read 

2 - file open (no operation) 

3 - file close (no operation) 

It - device close (clear EOF field in LPDT) 



QWBCT - Word or byte count and control returns. On initiation 
specifies a word count if positive or a byte count if 
negative. At completion of the request this location contains 
the actual transmission count in the same units as the call 
specified. Odd counts are rounded up to produce reads of an 
even number of bytes. All counts are truncated to produce 
maximum reads of UO words for ASCII or 80 words for column 
binary. 



QPAR1 - End of file specification. See EOFCHECK write up for details. 
QPAR2 - Binary/ASCII specification. 



BINAR7 If then ASCII code conversion; UO words maximum read. 
If not then column binary read; 80 words maximum read. 



QSTAT - Request completion status and PCB number associated with this 
request . 



PCBN PCB number associated with request. If zero this IOQ 
element is returned by the system when the request is 
completed . 

STATUS General Status. See general IOQ entry for specifications. 

QUALIFIER Driver specific status. See general 100 entrv. 
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IOQ ELEMENT FOR HPIB CARD READER 



1 2 3 U 5 6 7 8 9 10 11 12 13 l 1 * 15 MNEMONIC 

0| Request dependent flags (see below) | QFLAG 

+ — +--+--+--+ — +--+--+--+--+--+ — + — +--+ — +--+--+ 
1| S7SDB relative pointer to next IOQ element. | QLINK 

| Points to first word of element. | 

+ + + 

2 1 | Logical device number | QLDEV 
+ — + — +__+_.+__+ +--+ + + + 

3| Auxiliary buffer flag. | QMISC 

+--+--+--+--+--+ + + + + 

U| S| If QFLAG. (3:1) is clear then this is the | QDSTN 

| | DST number of the target data segment. If | 

j j S is set, QADDR is DB relative. j 

+__+ + 

5 | Offset in the data segment or system buffer 1 QADDR 
| table to the target data buffer. | 

+ + + 

6 | | Function code for | QFUNC 

| | this request. (See 

| | next section. ) | 

+ + + 

7 | On initiation, specifies the word count (>0) | QWBCT 

! or byte count (<0). At completion of the | 

| request this location contains the actual 

| transmission count in the same units (bytes j 

| or words) as in the request. I 

+ + 

%10| Parameter 1. Contains the EOF specification | QPAR1 

+ + 

%11| Parameter 2. Contains the data mode | QPAR2 
| specification in bits (11:2). (See below card | 
| reader request codes for detail information) j 

+ + + + 

%12| PCBN | QUALIFIER | STATUS | QSTAT 
+ + + + 



QFLAG - Request dependent flags 



Bit ABORT 



Bit 


1 


SPECIAL 


Bit 


2 


DIAG 


Bit 


3 


SYSBUFF 


Bit 


U 


IOWAKE 


Bit 


5 


BLOCKED 


Bit 


6 


COMPLETED 



Abort this request and return an error indication 

to the caller. 

Apply special handling to this request. (Not used) 

This is a request from the diagnostic subsystem. 

Target is an index relative to the SBUF Table of 

the data buffer. 

Wake caller on completion of request. 

Blocked I/O. The caller is waited in ATTACHIO 

until the request is completed. Implies IOWAKE. 

The request has been completed and the caller 

awakened if he had requested (with IOWAKE) . 
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Bit 7 


DATAFRZN 


Bit 8 


MAMERRORD 


Bit 9 


PREQ 


Bit 10 


SFAIL 



Bit 11 PFAIL 



Set by the memory management routines (MAM) when a 
MAKEPRESENT request is successfully completed and 
indicates the data segment is frozen in memory. 
An error has occurred while MAM was trying to 
make the target data segment present and freeze 
it in memory. 
(Not used) 

Delayed failure of SIO instruction. If a call to 
STARTIO resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed when the request was selected 
for execution. 

The request was aborted because of a system power 
failure . 



QMISC - Auxiliary buffer flag used to indicated a read into the 
driver's buffer and not the user's buffer. 



QSTAT - PCB number and request completion status. 

PCBN - The Process Control Block (PCB) number of the process 
which made this request. If zero, the request is not 
associated with any process and the IOQ element is to 
be returned by the system when the request has completed. 

STATUS - General status indicating the final state of the request. 
The following codes are used: 

- Not started or awaiting completion. 

1 - Successful completion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 
k - Irrecoverable error has occurred. 

QUALIFIER - A code which further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 
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CS 80 DISC IOQ ELEMENT (IOQ) 

1 2 3 h 5 6 7 8 9 10 11 12 13 1U 15 MNEMONIC 
+ _ + 

0| Request dependent flags (see below) | QFLAG 
+ + 

1| Request urgency class | QURGCLASS 

+ + + 

2 | Uhit# | Logical device number | QLDEV 
+ +--+--+--+ — + +--+--+ + + 

3|CHANF|RS|0P|IM|SR|RTRAN|LF|SP| | WAITCODE | QMISC 
+ +--+--+--+--+ +--+ — + + + 

U| S| DST (If process disc I/O) | QDSCTN 

I -I 

I DST (If segment transfer) [S=Stack] | 
+__+ + 

5 1 Offset in the data seg (If process disc I/O) | QADDR 

I 1 

| Address in Bank (If segment transfer) | 
+ + + 

6 1 | Function code for | QFTJNC 

I | this request. | 
+ + + 

7| On initiation, specifies the word count (>0) | QWBCT 
| or byte count (<0). At completion of the | 
| request this location contains the actual | 
| transmission count in the same units (bytes | 
| or words) as in the request. | 

+ + 

%10| PI - Parameter 1 (Usually High Order of | QPAR1 

| Current Logical Disc Address [CLDA1]) | 
+ + 

%11| P2 - Parameter 2 (Usually Low Order of | QPAR2 

I Current Logical Disc Address [CLDA2]) j 
+ + + + 

%12| PCBN | QUALIFIER | STATUS | QSTAT 
+ + + + 

%13l Sysbase relative indx of previous req in queue | QPREVREQP 
+ + 

%lk\ Sysbase relative indx of next req in queue | QNEXTREQP 

+ + 

%15l Segidentifier (If segment transfer | QSEGIDENT 
+ + 

%l6\ Displacement of read or wrt from seg base (MM) | QSEGDISP 

%iTis | IlllllllllllllllilllllltllUIIIIUIIIIIIIIII I 

I W | //////////////////////////////////////////// | 
I A | //////////////////////////////////////////// 1 

i p 1 1 in nun mum ii ii i ii ii i ii ii 1 1 ii i iii i in i 

+ + 
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QFLAG - Request dependent flags 



Bit ABORT 

Bit 1 MMREQ 

Bit 2 DIAG 

Bit 3 SBUF 

Bit U IOWAKE 

Bit 5 BLOCKED 

Bit 6 COMPLETED 

Bit 7 DATAFRZN 

Bit 8 MAMERRORD 



Bit 9 PREQUEUED 
Bit 10 SFAIL 



Bit 11 PFAIL 

Bit 12 CURREQ 
Bit 13 DISABLED 
Bit Ik DISATMPT 
Bit 15 MSGDONE 



Request has been aborted externally. 

Request is for a segment transfer. 

This is a request from the diagnostic subsystem. 

Target is an index relative to the SBUF Table of 

the data buffer. 

Wake caller on completion of request. 

Blocked I/O. The caller is waited in ATTACHIO 

until the request is completed. Implies IOWAKE. 

The request has been completed and the caller 

awakened if he had requested (with IOWAKE). 

Data segment has been present and is frozen. 

An error has occurred while MAM was trying to 

make the target data segment present and freeze 

it in memory. 

Request is queued into disc's request queue 

Delayed failure of SIO instruction. If a call 

to STARTIO resulted in the request being added 

to the channel queue, this bit indicates that 

the SIO instruction failed when the request was 

selected for execution. 

The request was aborted because of a system 

power failure. 

Request is device's current request. 

Request is disabled. 

Attempt to disable this request. 

A message request reply has completed. 



QLDEV.QLDEVN - Logical Device Number 

QMISC - Driver request dependent flags and counters. 



CHAN' ERR 'FLG 
RSTAT'FAIL'FLG 
OPER'REQ'FLG 
IM' FAULT 'FLG 
STAT 'RTRY' FLG 
RTRANS'FLG 
LOAD 'FLG 
SYS 'PFAIL 'FLG 



Channel error retry flag. 
Request status failed flag. 
Operator requested release flag. 
Internal maintenance fault flag. 
Status error single retry flag. 
Retransmit required flag. 
Media load flag. 
System powerfail flag. 



WAITCODE 



- Indicates type of wait: 



- new request 

1 - completion wait 

2 - not ready wait 

3 - release/release deny wait 
U - IOQ defer wait 

5 - DSCT read wait 

6 - DSCT write wait 

7 - synchronization wait 
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QDSTN - If system buffer is clear then this is the DST 
number of the target data segment. If bit is 
set then buffer address is a DB offset value 
instead of segment relative offset (implemented 
for NOWAIT I/O and NOBUFF). 

QADDR - Offset in data segment or system buffer table to 
target data buffer. 

QFUNC - Function code and qualifiers as specified by 
driver. 

QSTAT - PCB number and request completion status. 

PCBN - The Process Control Block (PCB) number of the process 
which made this request. If zero, the request is not 
associated with any process and the IOQ element is to 
be returned by the system when the request has completed. 



STATUS 



General status indicating the final state of the request. 



- Not started or awaiting completion. 

1 - Successful completion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 
U - Irrecoverable error has occurred. 

QUALIFIER - A code which further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 
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CS 80 INTEGRATED CARTRIDGE TAPE REQUEST 
IOQ ELEMENT 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 MNEMONIC 



+- 

0| 
+- 

II 

+- 

2| 
+- 



Request dependent flags (see below) 



-+ 

I 
-+ 



QFLAG 



Request urgency class I QURGCLASS 
+ + 

Uhit# | Logical device number | QLDEV 
-+--+--+--+ +--+--+ + + 



3|CHANF|RS|OP|IM| RETRY |LF|SP| | WAITCODE | QMISC 

+ +--+ — + — + + — + — + + + 

U| S| DST (If process disc I/O) | QDSCTN 

I " 1 

| DST (If segment transfer) [S=Stack] | 
+__+ + 

51 Offset in the data seg (If process disc I/O) i QADDR 

i - - - I 

| Address in Bank (If segment transfer) | 
+ + + 

6 | I Function code for | QFUNC 
j | this request. | 
+ + + 

7| On initiation, specifies the word count (>0) | QWBCT 
j or byte count (<0). At completion of the | 
j request this location contains the actual j 
j transmission count in the same units (bytes | 
| or words) as in the request. I 

+ + 

%10| PI - Parameter 1 (Usually High Order of j QPAR1 
I Current Logical Disc Address [CLDA1]) | 
+ + 

Jill | P2 - Parameter 2 (Usually Low Order of | QPAR2 
I Current Logical Disc Address [CLDA2]) | 
+ + +- — + 

#12 | PCBN | QUALIFIER | STATUS | QSTAT 
+ + + -+ 

%13| Sysbase relative indx of previous req in queue | QPREVREQP 
+ + 

%lk\ Sysbase relative indx of next req in queue | QNEXTREQP 
+ + 

51151 Segidentifier (If segment transfer | QSEGIDENT 
+ --+ 

5416 | Displacement of read or wrt from seg base (MM) | QSEGDISP 
+ + 

%17 I S | //////////////////////////////////////////// I 

|W I////////////////////////////////////////////I 

|A | //////////////////////////////////////////// I 

IP I //////////////////////////////////////////// I 
+ + 
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QFLAG - Request dependent flags 



Bit ABORT 

Bit 1 MMREQ 

Bit 2 DIAG 

Bit 3 SBUF 

Bit k IOWAKE 

Bit 5 BLOCKED 

Bit 6 COMPLETED 

Bit 7 DATAFRZN 

Bit 8 MAHERRORD 



Bit 9 PREQUEUED 
Bit 10 SFAIL 



Bit 12 CURREQ 
Bit 13 DISABLED 
Bit lit DISATMPT 
Bit 15 MSGDONE 



Request has been aborted externally. 

Request is for a segment transfer. 

This is a request from the diagnostic subsystem. 

Target is an index relative to the SBUF Table of 

the data buffer. 

Wake caller on completion of request. 

Blocked I/O. The caller is waited in ATTACHIO 

until the request is completed. Implies IOWAKE. 

The request has been completed and the caller 

awakened if he had requested (with IOWAKE) . 

Data segment has been present and is frozen. 

An error has occurred while MAM was trying to 

make the target data segment present and freeze 

it in memory. 

Request is queued into disc's request queue 

Delayed failure of SIO instruction. If a call 

to STARTIO resulted in the request being added 

to the channel queue, this bit indicates that 

the SIO instruction failed when the request was 

selected for execution. 

The request was aborted because of a system 

power failure. 

Request is device's current request. 

Request is disabled. 

Attempt to disable this request. 

A message request reply has completed. 



QLDEV.QLDEVN - Logical Device Number 

QMISC - Driver request dependent flags and counters. 



CHAN'ERR'FLG 

RSTAT'FAIL'FLG 

OPER'REQ'FLG 

IM' FAULT *FLG 

RETRY 'COUNT 

LOAD'FLG 

SYS'PFAIL'FLG 



Channel error retry flag. 
Request status failed flag. 
Operator requested release flag. 
Internal maintenance fault flag. 
Retry count area. 
Media load flag. 
System powerfail flag. 



WAITCODE 



Indicates type of wait: 



- new request 

1 - completion wait 

2 - not ready wait 

3 - release/release deny wait 
U - IOQ defer wait 

5 - DSCT read wait 

6 - DSCT write wait 

7 - synchronization wait 
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QDSTN - If system buffer is clear then this is the DST 
number of the target data segment. If bit is 
set then buffer address is a DB offset value 
instead of segment relative offset (implemented 
for NOWAIT I/O and NOBUFF). 

QADDR - Offset in data segment or system buffer table to 
target data buffer. 

QFUNC - Function code and qualifiers as specified by 
driver. 

QSTAT - PCB number and request completion status. 

PCBN - The Process Control Block (PCB) number of the process 
which made this request. If zero, the request is not 
associated with any process and the IOQ element is to 
be returned by the system when the request has completed. 

STATUS - General status indicating the final state 6f the request. 

- Not started or awaiting completion. 

1 - Successful completion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 
h - Irrecoverable error has occurred. 

QUALIFIER - A code which further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 
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SBUF AND TBUF TABLE LAYOUT 



SECONDARY # 


1 


PRIMARY # 


IMPEDED 


PROCESS 


PCB | 


ENTRY 


SIZE 


HEAD INDEX 


TAIL INDEX 


MAXIMUM 


OF IN 


USE | CURRENT 


IN USE 


OVERFLOWS 


TOTAL 
REQUESTS 


INDEX OF 5 



ENTRY 1 



ENTRY 2 



INDEX OF 1 



ENTRY 3 



INDEX OF 2 



ENTRY U 
(IN USE ) 



INDEX OF k 



ENTRY 5 



TSIZE 

TREAD 

TTAIL 

TUSE 

TOVRFL 

TRQSTS 



3-1-5-U-2 
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TABLE ELEMENT ALLOCATION (TBUF AND SBUF) 



The allocation of the elements in the IOQ terminal buffer (TBUF) and 
system buffer (SBUF) tables is of concern to the I/O system. 



FREE LIST OF TABLE ELEMENTS 

These tables are in the form of a free-linked list of the free elements. 
For the SBUF's the -1 word of entry is the link to the next element. 
For the TBUF's, word zero is the link and word 1 is the link for the 
IOQ elements. 

Each word has an 8-word header beginning at the base of the table. The 
first four words of the header are for managing' the table and the second 
four are for monitoring table activity. 

The entries follow the header at word eight. 



ELEMENT ALLOCATION 

Elements are obtained from the beginning of the free list, pointed to 
by the head and returned to the end of the free list pointed by the tail. 

When the free list is empty, the head index is zero and the tail index 
is set to point at the head index. 

The tables are divided into two areas: a primary and a secondary area. 
Most requests are obtained from the primary area. The secondary area is 
used only for critical requirements when the primary area is exhausted. 
These areas are logical areas determined by parameters in the header. 

The utility of the core resident tables is seriously reduced if their 
use is not restricted to dynamic situations. 

One of three responses must be specified to the routines which allocate 
elements from the I/O system tables. 

1. Impede caller if primary is empty. 

2. Get from primary area only. 

3. Get from secondary area if primary area is empty. 
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TABLE ELEMENT ALLOCATION (CONT.) 



Request types 2 and 3 return an indication to the caller if the request 
could not be satisfied. The following table specifies the types of calls 
for element allocation and the action if an element is not activated. 



BUFFER USER 
SBUF's 



CALL TYPE 



FINAL ACTION 



File system 
Ptape 
Bad track 

TBUF's 

Terminal write (impedable) 
Terminal write (not impedable) 

Log error 

IOQ's 

ATTACHIO (not impedable) 
ATTACHIO (impedable) 
SIODM (memory management) 
IOMESSAGE 



Impede 
Impede 
Primary 


Forget request 


Impede 
Primary 
Secondary 
Primary 


I/O error 
I/O error 
Forget request 


Primary 
Impede 
Secondary 
Secondary 


Return IOQX-0 

Sudden death 
I/O error 



HEADER DEFINITION 



Primary # 
Total # 
Size 

Impeded PCB 

Head index 
Tail index 
In use 
Overflows 
Total requests 



Number of elements in the primary area. 

Total number of elements in the table. 

Size in words of each element. 

If not zero then contains the PCB number of the 

first process waiting for an element in this table. 

Index of first free element. 

Index of last free element. 

Current number not in free list. 

Number of requests made for an element. 

Total number of elements requested. 
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ICS GLOBAL 



QI 



1 
63. 

50. 


RESERVED 


U9 


CANDPIN 


U8 


LAST WEIGHT 


U7 
U6 


PAUSETIME 


U5 


LISTSTATE 


W 


CUREFILTER 


1+3 
U2 


CURDFILTER 
CWINUM 





Ul 


CWTDENOM 


Uo 
39 


CURCFILTER 
MAXCFILTER 


.___> 


38 


MINCFILTER 


37 


ESCHEDBASE 


36 


DSCHEDBASE 


35 


CSCHEDBASE 


•ah 


WORSTEPRI 


33 


WORSTDPRI 


99 


WORSTCPRI 


31 


XDSEG Bank for 


PMBC 


30 


XDSEG Addr for 


PMBC 


29 


XDSEG lim for 


PMBC 


28 


Status for 


PMBC 
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QI 



27 
22 


. RESERVED 


21 
20 


PAUSETIME 


19 


PAUSECODE 


18 


DISAP | 


17 


Reserved | 


16 


SDST | 


15 


PSTA | 


Ik 


PADDR | 


13 


TRACE FLAG j 


12 


PFAIL | 


11 


JCUT | 


10 


XP ! 


9 


PCBX | 


8 


z 1 


7 


DL | 


6 


s 


5 


SBANK j 


U 


STDB 


3 


o i 


2 


P 1 


1 


STATUS j 





P | i 


+1 


DB BANK RETURN | 




DB RETURN | 




D | PARM | 



MPE III ONLY1 
MPE III ONLY! 

MPE III ONLY1 

PSEN, PSDB counter 

process* stack DST# 

pseudo- interrupt status 

pseudo- interrupt address 

flag set non-zero on IXIT away from ICS 

PTR to powerfail PCB 

absolute JCUT address 

pointer to executing process PCB 

absolute stack address 

stack DB relative Z 

stack DB relative DL 

stack DB relative S 

stack bank 

absolute stack DB 



> DISPATCH stack marker 



> FOR DISPATCH 
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P=PSEUDO-DISABLED AND DISP INSTRUCTION EXECUTED. 
D=DISPATCHER INTERRUPTED. 



-19 PAUSECODE(MPE III ONLY): = system not paused 1 = paused for dis< 

2 = paused for swap 3 = system idle 



ICS GLOBAL CELLS, with initial values 



STDB - absolute address of the currently running process's stack. 
SBANK - bank address for process* stack. 
S - stack DB relatives 
DL - stack DB relative DL 
Z - stack DB relative Z 
PCBX - absolute stack address 

XP - PCB table relative pointer to word of the running process' 
PCB. 

The above cells are to be initialized for the PROGENITOR. 



CPCB - absolute U, is an absolute version of XP. If CPCB is zero, 
then the above cells are invalid. This will never be the 
case in a process. CPCB should also be set by INITIAL. 

SDST - DST# for running process' stack. 

JCUT - the bank zero absolute address of the JCUT table. 

PADDR - PB relative address for the procedure PSEUDOINT. 

PSTA - status value for PSEUDOINT, #lU0000+CST# . 

DISAP - PSDB counter, initially 0. 

INITIAL sets the above as described. 
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CS 80 DISC Interrupt Linkage Table (ILT) 



There is one ILT for each device controller configured on the 

system . 

A controller may support more than one unit, however the CS'80 

disc 

driver will only concern itself with the single unit controller. 

1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 MNEMONIC 

0| Channel I ICPVAO 

1| Program j ICPVA1 

2 1 Variable j ICPVA2 

3| Area (ICPVA) | ICPVA3 

+ + 

k\ DMA Abort I ICPVAU 

51 Address I ICPVA5 

+ + 

6\ j ISRQL 

+--+ + + + + 

71 LI | CHANQUE | | CHAN | DEV | ICNTRL 
+--+ + + + + 

%10| S7SDB relative pointer to channel program area| ISIOP 
+ + 

Jill | SYSDB relative pointer to idle status area | ISTAP 

+ + 

Jtl2| single instruction that is executed to extract | IUNIT 
j the device unit number from the status pointed | 
I to by ISTAP. [Since only Unit exists on the j 
j CS'80 discs, ANDI is used to return Unit 0] j 

+ + 

%13| SYSDB relative DIT pointer of the device | ICDP 
| currently using the channel to perform a I 

| data operation. 1 

+ + + 

%lk\ SIOPSIZE | CQUEN | IQUEUE 

+--+--+--+ + + + 

%15|RW|WP|IG| I HCUNIT | IFLAG 
+--+--+--+ + + 

%16\ SYSDB relative DIT pointer for unit | IDITPO 
+ + 

%n\ 20 bytes status area for idle channel program | ISTAT 
+ + 

• I • I 

+ + 

• I . I 

+ + 

#31 I CS'80 Discs I 

Channel 

| Program I 

+ + 
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ICPVAO - Channel Program Variable Area 

The first word is used by the channel program processor to 

store 

status information after I/O channel aborts. The next word is 

used 

by the driver to indicate if status should be examined for 

special 

conditions or errors. The other two words are not used. 



ICPVAU - DMA abort address 

If a DMA abort occurs, the absolute address where the abort 

occurred 

is stored in this area. 



ICNTRL - Contains controller information 

LIM - If this bit is set, the controller is sharing a 
software 

channel resource in order to limit bandwidth. 
CHANQUE - The software channel resource number. 
CHAN - Channel number (four most significant bits of DRTN). 
DEV - Device number (three least significant bits of DRTN) 



IQUEUE - 

SIOPSIZE - (number of words + l)/2 in the channel program area. 
CQUEN - For a multi-unit controller this field contains the 
software controller resource number. 



IFLAG - Controller and Channel Program state flags 

RUNWAIT - An Idle Channel Program should be started when there 
are no active requests to process. 

WAITPROG - An Idle Channel Program has been started for this 
controller. This bit is reset by an interrupt. 

IGNOREHI - An HIOP instruction has been issued against this 

con- 
troller but the channel program was not in a wait 
statement. Therefore ignore the interrupt generated 
by 
the channel code when this program halts. 

HCUNIT - Highest configured unit number for this controller. 

ISTAT - 20 bytes of status from the idle channel program. 
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CHAPTER lU SPOOLING 
INPUT DEVICE DIRECTORY/OUTPUT DEVICE DIRECTORY 
IDD/ODD (Common attributes referred to as XDD) 



IDD: DST = U5 (= %55) 
SIR » 3 



ODD: DST = U6 (= %56) 
SIR = U 



Overview of table structure 



Entry (8 words) 
Subentry area pointer 



Head entries (U words each) 



Subentries {%$6 words each) 



Entry (overall table definitions) 
1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

0| Maximum size i Current size |0 (sectors) 
+ + .___ = = = _ = »=+ 

1| Head entry size = U | Subentry size = %36 |1 ( words ) 
+ + + 

2| Subentry area pointer (segment relative) |2 
+__+ + 

3|DD| Next avail device file ID (DFID) |3 
+__+ + + 

U I /////////////////////////////////// I Fence | k 
+ + + 

5 1 liiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiilii 1 5 

6 1 /////////////////////////////////////////////// 1 6 
+ + 

7 1 /////////////////////////////////////////////// i 7 
+ + 

DD: ==> This is the IDD, 
1 ==> This is the ODD. 

Fence: For spooled output devices (ODD), the system-wide out- 
fence. For spooled input devices (IDD), the jobfence. 
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Typical head entry (U words) 

1 2 3 h 5 6 7 8 9 10 11 12 13 lU 15 

| Device outfence | Logical device | 
+ + _ + 

I Head pointer | 

+ --+ 

I Tail pointer | 

I///////////////////////////////////////////////I 
+ -+ 

There are two types of head entry, a class entry and a logi- 
cal device entry. There is only one class entry, if it exists 
at all, and it is the first head entry in the XDD. All spoo- 
fles opened by class (e.g., LP, SLOWLP, EPOC, PP, etc.) are 
linked to this entry. There is one logical device entry for 
each real (physical, as opposed to virtual) device on the sys- 
tem. Output devices appear in the ODD, input devices in the 
IDD. AC/DC devices such as terminals appear in both directo- 
ries. 

Each head entry is linked to or more subentries (a typical 
subentry is shown in the next table). A null chain (0 suben- 
tries) consists of head pointer = and tail pointer = seg- 
ment-relative address of the associated head pointer. If one 
or more subentries exists, the pointers are segment-relative 
addresses of the first word of the first and last subentries 
of the chain. Any intermediate subentries are linked through 
the subentries. The tail subentry always contains a 0-link. 

The Device Outfence and LDEV# fields are meaningless for the 
class entry. For logical device entries (non-0 Logical Device 
field) , a non-0 Device Outfence means that this outfence over- 
rides the system-wide outfence in word k of entry 0, but only 
for this device. 
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Typical subentry (%36 words) 




51 
+ 

61 

71 

10| 

111 

+ 

12| 
131 
1*1 
151 

161 
171 
20 i 
21 J 

22|I0| 



Account name 



Job name 



5 

+ 

16 
17 
18 
19 

110 
111 
1 12 
113 

I1U 
115 
116 
117 

118 

+ 

23 1 FS | DA | ////////////// ///^He ad index ( see expTj^l9_ 
2Hj Logical device j Sector address... !20 



File name 



Device file ID 
+- 



---+ 



251 



I 



of spoof le label. 
Virtual LDEV 



26 | Number of extents 

+ + 

27| Last extent size (sectors) 

+ — +--+ — +--+--+ — + — + 

30|SQ|//|RS|FD|SO|AB|//| Number of copies 

+ — +--+ — +--+--+--+--+ 

31 I Segment-relative link to next subentry, 

j this device or class. ==> last subentry. 

+ 

32 1 Number of records in spoof le (doubleword) 

331 

+ 

3U| Time (CLOCK intrinsic format) at which 



121 
-+ 

1 22 
-+ 

123 

-+ 

1 21* 
-+ 

i25 

I 
126 

JZJ 
-+ 
|28 



I spoof le was made READY, or 0D if not closed | 

35| properly (say, because of a system failure) |29 

+ -+ 
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Word 0: TL 

State 



CL 



Word 1 : Type 



Word %22: 


10 


Word %23: 


FS 




DA 


Word %2k: 


LDEV 



Word #26: LDEV 

Word %30: SQ 

RS 
FD 
SO 
AB 



A bit reserved for tape labels. 
State of subentry: 

==> Active 

1 ==> Ready 

2 ==> Open 

3 ==> Locked 

-- 1 ==> DEVICE field is a class index into 
the Device Class Table. 
==> DEVICE field is an LDEV number. 

— Describes which environment created the 
subentry: 

==> Session' (SPOOK) 

1 ==> Session 

2 ==> Job 

3 ==> Job' (SPOOK) 
-- 1 ==> Output DFID 

==> Input DFID 

-- There are one or more forms message re- 
quests in the spoof le. 

-- The spoof le was created via a :DATA record 
(input spooling only). 

-- The logical device in class SPOOL where 
the file label (first extent) of the spoo- 
fle lives. 

-- LPDT index of virtual device LDEV. Simulates the 
properties of a real LDEV to the process which 
FOPENs a new (previously non-existing) spool 
file (State field (XDD(O) . (1:2)) = 2 (Open)). 

— 1 ==> Squeeze (purge) spoof le extents as 

the final copy is printed. 
==> Purge only when final copy printed. 

— 1 ==> Restart job when warms tart ing (input 

spooling only) . 
-- 1 ==> There are non-standard forms on the 

device. 
-- Spaced Out bit. File System could not ac- 
quire a new extent when creating spoof le. 
-- This is the $STDLIST of an aborted job. 



Head index: The (segment-relative address)/!* of the head en- 
try with which this subentry is linked. Since 
head entries are four words long, this can be 
thought of as an index into the head entry por- 
tion of the XDD --if you disallow values of 
and 1. Cute, huh? 
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SPOOK Output Tape Format 



The overall format of output tapes produced "by the SPOOK "OUTPUT" 
command is shown below. The various components of the tape are 
then described in detail. The format described here is subject 
to change as MPE evolves. Also, there may be errors in SPOOK 
which would cause the actual tape format to differ from the one 
described here in some cases. All numeric information is in 
integer format unless otherwise specified. 



EOF 

EOF 

Label Record 

EOF 

File Directory Records 

Device and Class Directory Record 

EOF 

Spoolfile 

EOF 

Spoolfile 

EOF 



Mechanisms for End-of-tape and tape switching are the same as for 
STORE/RESTORE tapes. 



Label Record 



Words 0-13 

Word 23 

Word 2k 

Words 25&26: 
JO*}! 



»»SP00LFILETAPE LABEL-HP3000. 
reel number (first reel is number 1) 
date (from CALENDAR intrinsic) 



time (from CLOCK intrinsic) 



U TA$£. V 1 ' 



lU-5 



All other words are zero. 



File Directory 

The File Directory has one entry for each spoolfile on the tape. 
Each entry is 12 words, and entries are packed into as many 1020- 
word records as needed. The last record will be padded with 
zeros if necessary. The entry format is: 



Word 



0: 



Words 1-3 
Words U-7 
Words 8-11 



Device file id number (bit is on to indicate 
that the file is an output spoolfile) 

zero 

User name 

Account Name 



Device and Class Directory 

The Device and Class Directory is contained in one 102U-word 
record. There is no EOF separating this record from the File 
Directory. This directory contains one entry for each logical 
device or device class linked to the spoolfiles on the tape. 
Also, there is an entry for each logical device in each class in 
the directory, whether or not that logical device was directly 
referenced by a spoolfile. The entries are packed into the tape 
record one after another in no particular order. The entry 
formats are shown below. 



Logical Device Entry 

Word 0: logical device number 

Word 1: Bits 0:8 : device subtype 

Bits 8:8 : 3 (=length of this entry in words) 



Word 2: device type 
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Device Class Entry 

Word 0: Device class number (negated). This is the number 
of the entry of this device class in the system's 
Device Class Table. 

Word 1: Total number of words in this entry. 

Words 2 on: The entire contents of the Device Class Table entry 
for this device class. 

There is one known bug in the Device and Class Directory. The \ ^ f> p Q <" f -*-^~L 
last logical device in each class will be skipped when generating \ C'-.^ J 
device entries for the members of the class. Unless that logical J 
device is entered into the directory for some other reason, it J '^ 
will not be present . *^p £_ V 

Spoolf ile Format v* ^* e 

ODD entry (30-word tape record) 

Spoolf ile block > Two spoolf ile blocks packed into one 

Spoolf ile block 102U-word tape record. 

Two spoolfile blocks 

Two spoolfile blocks 



The first few spoolfile blocks have been modified to contain 
user label information from the spoolfile. This is explained 
later. 



Spoolfile Block Format 



A spoolfile block is a 512-word block that contains variable 
length records in spooler format. The 2680 is intimately famil- 
iar with this structure. Any effort to change this format should 
be cleared with the 2680 project in Boise first! Spoolfile rec- 
ords start at the first word of the block. The last record is 
followed by a -1 to indicate that no more records follow. The 
last two words of the block contain a doubleword which is the 
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Spoolf ile Record Format 

Word 0: Byte count of record - 2 

Word 1: Byte count of data portion of record. Note 
that this count includes trailing blanks. 
However, trailing blanks are truncated in 
the actual record, so this count may be 
more than the number of bytes actually 
present in the data portion. 

Word 2: Function Code: l=Fwrite 

2=Fcontrol 
3=Fopen 
U=Fclose 
%200 and beyond=Fdevicecontrol 

Word 3: PI -- ATTACHIO parameter 

Word U: P2 — ATTACHIO parameter 

Words 5 on: Data Portion of Record 



User Labels Information 



In the C -Nit and newer MPE versions, spoolf iles have a number of 
user labels with several kinds of information. These are: 

1. Master: user label 0. 

2. FOPEN entry catalog: user labels 1-10. 

3. Circular queue for restart checkpointing: user labels 
11-27- 

Since older versions of MPE did not use user labels, a way was 
needed to incorporate them into the SPOOK tape format without 
losing forward and backward compatibility. The method used is to 
add several special spoolfile blocks to the beginning of the 
spoolf ile on tape. Each of these blocks has exactly one FOPEN 
record at its beginning. This record is followed by a -1. Thus 
old versions of MPE will assume that the rest of the block is 
garbage. However, the rest of the block is actually used to con- 
tain user label information. The first two spoolfile blocks 
(i.e. the first tape record of the spoolfile proper) contain only 
the FOPEN records. The next 5 tape records actually contain user 
labels in addition to the FOPEN records. The user labels are 
packed 3 to a spoolfile block, 6 to a tape record. Each spool- 
file block of 512 words has the following format: 
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Words 0-U: FOPEN record 

Word 5: "1 (to "terminate" the "block) 

Words %200-%377: user label 

Words %U00-%577: user label 

Words %600-%777: user label 

Following this special group of blocks, the spoolfile resumes a 
normal format. The special FOPEN records all have the number of 
user labels in P2. 

It is often the case that some of the 27 user labels have not 
been initialized before the tape is written. In that case, their 
places will be filled with garbage. There is no easy way of de- 
tecting this except by careful inspection. 

Since user labels are written 6 to a tape record and there are 28 
user labels, the last %U00 words of the final user label tape 
record are always uninitialized. 
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CHAPTER 15 UNIFIED COMMAND LANGUAGE (UNCL) 



REi'LY INFOkMATION TABLE (RIT) 

DST %3k; SIR %25 





1 
2 
3 



NUMBER OF ENTRIES 
MAX NUMBER OF ENTRIES 
POSITION OF NEXT FREE ENTRY SPACE IN QUEUE 

NUMBER OF QUEUED ENTRIES 
(52 WORDS TO HOLD PINI's OF QUEUED ENTRIES) 
UNUSED 
PROCESS NUMBER (PIN) 
DST# (FOR REPLY) 
BUFFER ADDRESS (DST RELATIVE) 
MAX LENGTH OF STRING | REPLY TYPE EXPECTED 



# BYTES IN MESSAGE 



MESSAGE IN ASCII 
(UP TO 86 CHARS.) 



NOTE: Process Number = means entry is empty 
Reply Type = for number (num) 

= 1 for yes or no (y/n) 

= 2 for string (sxx) 

= 3 for yes, no, or STRING 

= k for string 
TABLE SIZE = 20U6 words 
may # OF ACTIVE ENTRIES = 30 
MAX # OF QUEUED ENTRIES = 52 



\ 



TABLE 57 
HEADER wd 



ENTRY 

(51 ! 
wds) 
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MESSAGE SYSTEM GENERAL DESCRIPTION 



The message system consists of the following parts: 

- Callable intrinsic GENMESSAGE. 

- Uncallable procedure GENMSG which is used by MPE. 

- System message catalog ( CATALOG . PUB . SYS ) and any number of 
user catalogs. 

- Program MAKECAT which builds message catalogs. 

- MESSAGE SIR %2h 

- MESSAGE SYSGLOB CELLS %371"373 

- MESSAGE DATA SEGMENT 

The message system is used by calling GENMESSAGE (or GENMSG) with 
a message number. The message system fetches the message from a 
message catalog, inserts parameters, then routes the message to a 
file or returns the message in a buffer to the caller. 

A message catalog is a numbered editor- type file containing sets 
of messages. The sets serve to break a catalog into managable 
portions. A message system user may call GENMESSAGE using either 
his own message catalog or using MPE's catalog (CATALOG. PUB. SYS). 

After creating a message file, run the program MAKECAT in order 
to build a catalog that is readable by the message system. This 
file is still readable by the editor (it can be "texted") but it 
contains a directory (written as a userlabel) . 

In order to use the message catalog, the program must first open 
the message catalog, then call GENMESSAGE with the file number, 
set number and message number. (MPE users don't need to open the 
catalog, GENMSG automatically uses CATALOG . PUB . SYS . ) The file 
must be opened with the aoptions "NOBUF" and "MULTI" -record 
access. 

MESSAGE CATALOG 



Messages in the catalog can be of any length and can contain up 
to five parameters. Continuation of a message is indicated by 
"%" or "&" at the end of a line. The "%" symbol indicates that 
the message is continued and that a carriage return, line feed be 
issued the terminal. The "&" symbol indicates that the message 
is continued on the same line with no carriage return, line feed. 

Parameters may be inserted into the message fetched from the 
catalog. The parameters are passed in the GENMESSAGE (or GENMSG) 
call and inserted wherever a "!" is found. Message sets are 
indicated by "$SET n" starting in column 1 (the rest of the line 
is treated as a comment). Maximum value for n is 63. Comments 
can be inserted in the catalog by placing "$" in column 1. 
Message numbers are positive integers, need not be contiguous, 
but must be in ascending order. After processing by the program 
MAKECAT, the catalog file contains records of 80 bytes, blocked 
16, in 32 extents. (The system message catalog is only one 
extent, however). The format of the message catalog is as 
follows: 
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MESSAGE SYSTEM (CONT. ) 



$SET 1 SYSTEM MESSAGES 

1 LDEV #1 IN IKE BY FILE SYSTEM 

2 LDEV #! IN USE BY DIAGNOSTICS 

3 LDEV IN USE, DOWN PENDING 
5 IS "!" ON LDEV#! (Y/N)? 



$ MESSAGE 35 IS TWO LINES LONG, A PARAMETER STARTS THE 
$ FIRST LINE AND THE SECOND LINE IS "HP32002" 

35 •% 
HP32002B.00.1 



276 LDEV # FOR " 1 " ON ! (NUM) ! 

$ 

$SET 2 CIERROR MESSAGES 

82 STREAM FACILITY NOT ENABLED: SEE OPERATOR. (CIERR 82) 

200 MORE THAN 3Q PARAMETERS TO BUILD COMMAND. (CIERR 200) 



20U FILE COMMAND REQUIRES AT LEAST TWO PARAMETERS, INCLUDING 
THE 
FORMAL NAME OF THE FILE (CIERR 20U) 



MAKECAT PROGRAM 



The program MAKECAT . PUB . SYS is used to build message catalogs 
(and also HELP catalogs). The program's input file has the 
formaldesignator INPUT, which must be used for all entry points. 
The program has the following entry points: 



(no entry 
point) 



BUILD 



Reads from input file and builds a temporary file 
(formaldesignator CATALOG). Also renames any old 



+onmnr9rw PATAT.fV! fATVin 



—6 — 



numbering scheme (i.e., CAT1, CAT2, etc.). 
- (Must log on under MAN AGER . SYS . ) Reads from input 

— •»«.-••) ■««»*_« w«w w^f w V -w«* •■•WWWM^'W VWVS*A.Vg y*VAlUW.X 

designator CATALOG), and installs the message 
system. Existing catalog is renamed CATnnnn 
according to the same scheme as for no entry 
point (above). Installation of the message 
system means moving the directory contained in 
the user label of the catalog into a data segment. 
The DST number and the disc address of CATALOG 
are placed in system global area. The message 
system may be installed while the system is 
running. 
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MESSAGE SYSTEM (CONT. ) 



DIR - (Must have PM or OP capability.) Installs the 
system message catalog (does not build a new 
one). Opens input file, moves the directory in 
the CATALOG into a data segment, and places the 
DST number and disc address of CATALOG in system 
global area. This may be done when the message 
system seems to be "broken", but the catalog is 
intact. (MPE is issuing "MISSING MSG. SET=mm. 
MSG=nn" at terminals and at the console . ) This 
may be done while the system is running. 

HELP - Used to build the HELP catalog. Reads input file 
and builds a HELP catalog ( f ormaldes ignator 
HELPCAT) . 
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MESSAGE SYSTEM CATALOG. PUB. SYS 



$SET 1 - System messages. 

$SET 2 - CI errors and warnings messages. 

$SET 3 - Miscellaneous ABORT messages. 

$SET k - Program error abort messages. 

$SET 5 - Intrinsics abort messages. 

$SET 6 - Run-time abort messages. 

$SET 7 - CI general messages. 

$SET 8 - File System error, messages. 

$SET 9 - Loader error messages. 

$SET 10 - CREATE error messages. 

$SET 11 - ACTIVATE error messages. 

$SET 12 - SUSPEND error messages. 

$SET 13 - MYCOMMAND error messages. 

$SET Ik - LOCKGLORIN error messages. 

$SET 15 - Private Volumes error messages. 

$SET 16 - DS/3000 messages. 

$SET 17 - HELP facility error messages. 

$SET 18 - Graphic devices messages. 

$SET 19 - Serial Disc error messages. 

$SET 20 - User Logging error messages. 

$SET 21 - Association Utility (ASOCTABL) messages. 

$SET 22 - 2680A Page Printer messages. 

$SET 25 - 2680A Page Printer error file messages. 

$SET 26 - Disc Free Space messages. 

$SET 27 - System Internal Error messages. 

$SET 28 - CIPER Device Error messages. 
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MESSAGE SET DIRECTORY 



DST # IN SYSGLOB %373 

CAT DISC ADDR IN SYSGLOB %371"372 

CREATED BY RUNNING MAKECAT . PUB . SYS . 

KEPT IN A DATA SEGMENT AND IN A USER LABEL. 



% 


1 
2 

3 
k 

5 



50 
51 
52 
53 
5* 



DATA SEGMENT 
MAX. SET # 
# OF MESSAGE RECORDS 
RECORD OFFSET TO FIRST MESSAGE 

FIRST MESSAGE # 
RECORD OFFSET TO FIRST MESSAGE 
FIRST MESSAGE # 



EMPTY ENTRY 



RECORD OFFSET TO FIRST MESSAGE 



FIRST MESSAGE # 




RECORD OFFSET TO CURRENT MESSAGE 



MESSAGE 
BUFFER 
(6U0 WORDS) 



1253 

EMPTY ENTRY: 



RECORD OFFSET OF NEXT IN-USE SET 



\ 

| HEADER 

1 / 

2 \ 

| SET 1 

3 / 

U \ 

| SET 2 

5 / 



USER 
LABEL 



U0\ 

| SET 63 

in/ 



U2\ 

I 

U3/ 



CUR MSG 



683 
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HELP SUBSYSTEM 



HELP DIRECTORY 



KEPT AS USER LABEL 
READ ONTO USER'S STACK 
USES SEARCH INTRINSIC FORMAT 
VARIABLE ENTRY SIZE 



% 

! 
ol 



DIRECTORY SIZE (WORDS) 



1| ENTRY LGTH (BYTES) | KEYWORD LGTH (BYTES) 

I— - 

2| ENTRY 

j KEYWORD 

1-255 BYTES 



I— 1 

| ENTRY RECORD # IN CICAT | 

! LEFT BYTE | RIGHT BYTE ! / 

I -——I 

| ENTRY LGTH (BYTES) | KEYWORD LGTH (BYTES) | \ 

I- I 

j ENTRY I 

KEYWORD 
1-255 BYTES 



ENTRY 



ENTRY 



j j ENTRY REC # LEFT BYTE| 

I- 1 

JENTRY REC # R. BYTE \ ENTRY LGTH (BYTES) | / \ 

i - - ! 

| KEYWORD LGTH (BYTES) | I 



I 



ENTRY 

KEYWORD 

1-255 BYTES 



I 



| ENTRY REC # 

| LEFT BYTE | RIGHT BYTE 



ENTRY 



I / 
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UDCs 



UDC DIRECTORY 



"EXTRA DATA SEGMENT - DST # IN DB+J&250 OF UMAIN STACK 
*BUILT BY INITUDC 



0123 678 15 



|LT|LN|NH|NB| 


|TY | ENTRY 


SIZE 


I HEADER 


RECORD NUMBER 




I BODY 


RECORD NUMBER 




( FILE NUMBER | COMMAND 


LENGTH 


| COMMAND 

NAME 
(1-16 BYTES) 


ENTRIES 


1 1 



\ LT-OPTION LIST 
LN-OPTION LOGON 
NH-OPTION NOHELP 
NB-OPTION NOBREAK 
TY- 00=USER UDC 

01=ACCOUNT UDC 
10=SYSTEM UDC 

> ENTRY 



- I 



ENTRY SIZE=0 ENDS 
DIRECTORY 
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UDC'S 



COMMAND. PUB. SYS 



*RECORD SIZE = 20(10) WORDS, 6 RECORDS /BLOCK 
♦KEEPS TRACK OF WHO IS USING WHAT UDC CATALOG 
*CAN BE PURGED TO DISABLE UDC'S 
*CAN BE REBUILT TO REENABLE UDC'S 



# 



% RECORD 

I 1 

0|lst FREE ENTRY # |0 

I I 

1| not used |1 

I I 

2 | MAX IN USE | 2 

I I 

31 # IN USE |3 



k\ \k 

I not used I 



% FREE ENTRY # 
| 1 

0|NEXT FREE ENTRY #|0 

I 1 

1| ENTRY TYPE=0 |l 

I I 

2| |2 

I I 

not used 



231 



U9 



231 



1 19 
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COMMAND. PUB. SYS (cont.) 



USER ENTRY 




1 
2 
3 

k 

5 
6 

7 
10 
11 
12 
13 

114 

15 
16 

17 
20 
21 
22 
23 



CATALOG ENTRY # 
ENTRY TYPE=0 



USER* 



ACCOUNT* 



not used 



# 

1 
2 
3 
U 

5 
6 

7 
8 

9 

10 
11 
12 

13 
lit 

15 
16 

17 
18 

19 



54 FILE ENTRY 



o| 


NEXT CAT. ENTRY # 


n 


ENTRY TYPE ■ 2 


2| 






FILE NAME 


31 






FOPEN FORMAT: 


U| 




51 




6! 


FILE 


7 


[/LOCKWORD] 


10 


GROUP 


11 


ACCOUNT 


12 





13 




1U 






(UP TO 36 BYTES) 


15 




16 




17 




20 




21 




22 




23 







1 

2 
3 
k 

5 
6 

7 
8 

9 

10 

11 

12 

13 

1U 

15 
16 

17 

18 

19 



* IF THE USER FIELD AND THE ACCOUNT FIELD CONTAIN "g 
THIS INDICATES SYSTEM LEVEL UDC'S. 



IF ONLY THE USER FIELD CONTAINS § AND 7 SPACES, THIS INDICATES 
ACCOUNT LEVEL UDC'S. 
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CI STACK DEFINITION 











DB+JlO 




BCOMIMAGE (Byte Ptr. To Command) 




DB+Jli 


\l 
\ 
l\ 


COMMAND IMAGE 
(280 bytes) 


\i 


DB+%215 


\l 
\ 
l\ 


LINELENSTACK 
(30 words) 


\l 

\ 


DB+%253 


NEXTMSG (Not currently used) 




DB+%25 1 * 




THIS IS SPARE 




DB+JJ255 




UDCO 




DB+%256 




UDC1 




DB+%257 




T JDC2 




DB+#260 




UDC3 




DB+%26l 




wck 




DB+%262 




IFNESTING 




DB+%263 




IFSKIP 




DB+5&26U 




ELSESEEN 




DB+5&265 




CIFLAGS 




DB+%266 




CONTINUE STATE STACK 
(2 words) 




DB+%270 




PENDINGCOMLEN 




DB+%271 




BLASTCOMIMAGE (Byte Ptr.) 




DB+%272 


\l 
\ 
l\ 


LAST COMMAND IMAGE 
(280 bytes) 


\l 

\ 

1 
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Field Definitions 

BCOMIMAGE: Byte pointer to COMIMAGE (sometimes called WCOMIMAGE) 
in the CI stack. 

COMMAND IMAGE: Command character string currently being 
executed . 

LINELENSTACK: A CI command can span up to 30 input lines. This 
stack holds the length of each input line. 

NEXTMSG: Used to be used to link messages together. No longer 
being used. 

THIS IS SPARE: Not used. 

UDCO: Holds the DST number of the UDC definitions. 

UDC1: Holds the old S register value for UDCs. 

UDC2: (0:1)--FLUSHUDC, used by :SETCATALOG 

UDC3: UDC options for current UDC. 

UDCU: (0:1)- -UDC Fatal Ci Error 
(1:1)--UDC EXITBREAK 
(2:1)--UDC BREAKDETECTED 
(3:1)--UDC NOPRINT 
(U:l)— UDC IMAGEADJUST 
(10: 6)- -UDC NESTLEVEL 

IFNESTING: Level of nesting of :IF commands. 

IFSKIP: Whether the current commands are being skipped as the 
false part of a :IF command. 

ELSESEEN: Level of the :ELSE commands. 

CIFLAGS: (13:1) --Sequenced: line numbers at rear. 
(15:1) --Not REDOable (last command). 

CONTINUE STATE STACK: History of the : CONTINUE commands. 
= 0--no -.CONTINUE 
= l--just seen 
= 2- -in effect. 

PENDINGCOMLEN: If <> 0, command is already in stack and this 
word is the command string length. 

BLASTCOMIMAGE : Byte pointer to last command image. 

LAST COMMAND IMAGE: When a command completes execution, the 
command string is copied here for use by the :RED0 command. 
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ASSOCIATION DST LAYOUT 



i 
l 

I 

| Not 

I 

! Used 

I 

I 

j =„«=========================«„======: 

I Not Used | JMAT Index (8 bits) 
I - - 

Not Used | JIT Index (10 bits) 
- 

DST rel. index to user's next entry. 



Class name under which this ldev is 
associated. Left justified and 
padded with blanks. 8 bytes. 









| Don't 

I Care 

I 



1 rft 

1 w 


DST %k2 


1 1 




i 2 


SIR %30 


1 3 




i *♦ 




1 5 


One entry/ 


1 6 


system ldev 


i 7 


\ 


I 8 




1 9 


|- Ldev 1 




(Associated) 


i 10 




1 11 




| 12 




1 13 


/ 


1 1U 


\ 
■ 


1 15 


1 

1 
1 


1 16 


1 

|- Ldev 2 
I 




1 
(Unassociated 




) 


i IT 


i 


i 18 


1 


1 19 


1 


I 20 


/ 



JMAT Index or 



JIT Index or 
Next Entry Pointer or 



Classname 
or Don't Care 



7*n \ 



Ldev n 
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CHAPTER 16 SYSDUMP/INITIAL 



CTABO (Memory Size Independent Configuration Values) 





RECORD OF CONFDATA FILE 













MEMORY SIZE IN K WORDS 





1 


CORE SIZE INDEX 


1 


2 


STANDARD STACK SIZE 


2 


3 


HIGHEST DRT # 


3 


4 


TERMINAL BOUND PRIORITY 


It 


5 


NORMAL PRIORITY 


5 


6 


CPU BOUND PRIORITY 


6 


7 


# OF SECONDS TO LOG-ON 


7 


10 


LOG FILE RECORD SIZE (SECTORS) 


8 


11 


LOG FILE SIZE (RECORDS) 


9 


12 


LOG FILE # 


10 

11 .. Ol iH 


13 

1U 

15 
16 

1 T 


LOG BITS (ONLY 11 USED) 
<<DEFINES WHAT IS BEING LOGGED>> 


12 
13 
14 

* rr 


20 


DEFAULT JOB/SESSION CPU TIME LIMIT 


16 


o-i 


PTT TZC* T\TTIJTOT*T\ 




22 


HIGHEST LOGICAL DEVICE # 


18 


23 


HIGHEST VOLUME # | HIGHEST SYS. VOLUME NO. 


19 


24 


DEVICE CLASS TABLE SIZE 


20 
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RECORD (CONT.) 

I — - -- " I 

251 FIX LEVEL |21 

I " — - - — - 1 

26 | COLD LOAD COUNT 122 

| j 

271 MAX INITIAL SEGMENT SIZE |23 

j _.__ ___ , 

30 1 DISC COLD LOAD ENTRY POINT \2k 

j .__ ____ , 

31 1 SIZE OF OLD VOLUME TABLE 1 2"5 

I ----- 1 

32 | SIZE OF OLD COLD LOAD INFORMATION TABLE \Z6 

I — — - -I 

331 TIME QUANTUM (unused) |27 

j _.._ , 

3^1 MAXIMUM OPEN SPOOL FILES |28 

351 CSTAB SIZE |29 

36| | 30 

I MAXIMUM # OF SPOOL FILES (KILO SECTORS) j 

37 | 131 

I — — | 

*+0 1 # OF ADDITIONAL CS DRIVERS |32 

I— — - — | 

^11 # SECTORS PER SPOOL EXTENT |33 

' — — " I 

**2| UPDATE LEVEL l^h 

| _.._ __.. __.__j J 

**3 1 VERSION 1 35 

I — — " — - - -I 

Ml SERIAL DISC LOAD |FD|SD|36 
j _ _, 

**5l MIT VERSION 137 

| _ j J ' 

*»6| MIT UPDATE 138 

I I 

*»7l MIT FIX 139 

I - " - 1 

50|DR|TP| reserved for system |U0 

I conversion id's. | 

51 I All bits currently unused |Ul 

I must be zero. 

52| {k2 

531 !u 3 

I" " — - I 

DR = 7-bit DRT system TP = word 1* of CTAB is no. of TBUFS 
1 = 9-bit DRT system 1 = word k of CTAB is TBUFS 

per port 
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RECORD (CONT.) 



I - - i 

5U| TAPE RECORD SIZE (WORDS) | UU 

I " I 

-iiuiiiiiiiiiiiiinmuiiiiiiiiiiiiiiiiiiiiiir- 
1 — - -1 

177| RESERVED 12U(10)-127(10) |127 
I I 

SERIAL DISC LOAD (Word %kh) 

FD - Date given for sysdump was future date 
SD - Sysdump was to serial disc 
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record 

1 
2 

3 
k 

5 
6 

7 
8 



CTAB (Memory Size Dependent Configuration Values) 
RECORDS 1-8 OF CONFDATA FILE 



memory size k words 

61* 

80 

96 
128 
160 
192 
22U 
256 and larger 



This table describes the 
CTAB format in detail and is 
typical of any record (1-8) 




1 
2 
3 
U 

5 
6 

7 
10 
11 
12 
13 
Ik 

15 
16 

17 



# OF CST ENTRIES 

# OF DST ENTRIES 

# OF PCB ENTRIES 

# OF IOQ ENTRIES 

# OF TERMINAL BUFFERS PER PORT 
# OF CST ENTENSION ENTRIES 
INTERRUPT CONTROL STACK SIZE (Ql to Zl) 
# UCOP REQUEST QUEUE ENTIRES 
# BREAKPOINT ENTRIES 

# TRL ENTRIES 

# LOCAL RINS 

# GLOBAL RINS 

# OF SYSTEM BUFFERS 

# OF CONCURRENT PROGS 

# OF MAM TABLE ENTRIES 
reserved for type -ahead buffer size 




1 
2 
3 
U 

5 
6 

7 
8 

9 

10 

11 

12 

13 

1U 

15 
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RECORDS 1-8 (CONT.) 



20 | /////////////////////////////////////////////// I 16 
I— - 1 

I — " I 

2U | /////////////////////////////////////////////// 1 20 

I I 

25| DIRECTORY SIZE (SECTORS) |21 

I 1 

"///////////////////////////////////////////////"• 
-///////////////////////////////////////////////"• 

i— - - — — - --I 

36 j MAXIMUM CODE SEGMENT SIZE 1 30 

I " I 

37| MAXIMUM # OF CODE SEGMENTS /PROCESS 1 31 

I "j 

U0| MAXIMUM STACK SIZE (MAXDATA) 1 32 

1 — — ! 

1*1 j MAXIMUM EXTRA DATA SEGMENT SIZE 1 33 

I — - - -! 

U2 j MAXIMUM # OF EXTRA DATA SEGMENTS /PROCESS 1 3 1 * 

-///////////////////////////////////////////////"• 

I— - I 

50 j MAXIMUM # RUNNING SESSIONS |U0 

I- I 

51 j MAXIMUM # OF RUNNING JOBS \kl 

I " I 

52| # LOG PROCS l 1 *2 

I " I 

53| LOG ID'S |U3 

5U| # DISC REQUEST TABLE ENTRIES |UU 

I " I 

SRl * SPECIAL REQUEST TABLE ENTRIES 1^5 

"i :.::::---:: j 

56 j # PRIMARY MESSAGE TABLE ENTRIES |U6 



*7l * SWAP TART.E ENTRIES I U7 



• 1 1 



60| # SECONDARY MESSAGE TABLE ENTRIES j U8 
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DRIVER TABLE 



The Driver Table consists of 6 word entries, in correspondence to 
the LDEV entries, up to the highest LDEV used, entry zero is a 
dummy entry. 



l 2 3 ** 5 6 7 8 9 10 11 12 13 lU 15 



|..|.-|._|„|..|_.|._|..|_.|„|._|..|. 



DRT # 

"I I — 

CR| CHAN # | 



I 



I 



D 
I 



N 
M 



|DS 



UNIT # 
MASTER LDEV 



R 
V 



A 

E 



TYPICAL ENTRY 
FORMAT 



DS 
CR 

CHAN # 
MASTER LDEV 



DS DEVICE (if set DRT is zero) 

CORE RESIDENT 

CHANNEL # 

LDEV of device which this DS device is linked to. 

Words 2-6 contain the driver name. 
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SYSDUMP FORMAT 



READ - SIO - PROGRAM PROGRAM 



SIO PROGRAM 



ICS 



LOW CORE 



TCST 



CS TABLE 



DRIVER TABLE 



LPDT 



LDT 



DEVICE CLASS TABLE 



LDTX 



VTAB 



OLDVTAB 



DISC COLD LOAD INFORMATION TABLE 



CTAB 



CTABO 



CSDVR 



CSDEF 



INITIAL'S DB AREA 



STACK MARKER 



INITIAL'S SEGMENTS 
RIN TABLE 
NOT DUMPED IF DATE =CARRIAGE RETURN 



<---TAPE LOAD POINT 
<---SERIAL DISC LOAD POINT 
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SYSDUMP FORMAT (CONT. ) 



LOGGING IDENTIFIER TABLE 



DIRECTORY HEADER 
DIRECTORY 



XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 
SYSTEM PROGRAMS, SL, NON-STD. DRIVERS 



XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 
STORE/RESTORE HEADER 



XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 
STORE/RESTORE DIRECTORY 



XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 
USER FILES (SEPARATED BY "EOF's" 



STORE/RESTORE TRAILER 
XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 



XXXXXXXXXXXXXXXXXXX EOF 
XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 



NOT DUMPED IF DATE = CARRIAGE RETURN 



NOTE: ON DISC, READ-SIO-PROGRAM KEPT IN DISC LABEL. 
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STORE TAPE FORMAT 



FIRST VOLUME 



EOF 



XXXXXXXXXXXXXXXXXX EOF 



"STORE/RESTORE LABEL 
HP/3000." 



"VIIB" 



PARTIAL FIRST FILE FLAG 



CHECKSUM 
DIRECTORY INDEX OF FIRST FILE 



VOLUME NUMBER 
DATE 
TIME 



TAPEBLOCKSIZE (#WORDS/BLOCK;def=U096) 




13 

Ik 
15 

16 

17 
18 

19 

22 

23 
2k 

25 
26 

27 
28 



39 / 



HEADER 
kO WORDS 



DATE: 
0:7 last 2 digits 

of year 
7:9 Julian date 

TIME: 
25.(0:8) hours 

(8:8) minutes 
26.(0:8) seconds 

(8:8) .1 sees. 
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FIRST VOLUME (CONT. ) 



XXXXXXXXXXXXXXXXXXX EOF xxxxxxxxxxxxxxxxxxl 


1 


FILE NAME | 


GROUP NAME | 


ACCT. NAME | 


1 


xxxxxxxxxxxxxxxxxxx eof xxxxxxxxxxxxxxxxxxl 


FILES (separated by "EOF's") | 



\ 

|TYP FILE 
j ENTRY 
1(12 WDS.) 
/ 



VOLUME 
DIRECTORY: 
# ENTRIES 
DETERMINED 
BY TAPEBLOCK- 
SIZE 



\ 

| FILES 

I 

/ 
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STORE FORMAT 



SUBSEQUENT VOLUMES 



'STORE/RESTORE LABEL- 
HP/3000." 



"VIIB" 



PARTIAL FIRST FILE FLAG 
CHECKSUM 
DIRECTORY INDEX OF FIRST FILE 



VOLUME NUMBER 
DATE 
TIME 



TAPEBLOCKSIZE 



FILE NAME 



GROUP NAME 
ACCT NAME 



XXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXXXXX 



<FILES> 




13 

1U 

15 

16 FLAG=1: 
1st FILE 

17 ON THIS 
VOL IS A 

18 PARTIAL. 

19 
22 

23 
2U 

25 
26 

27 

28 
39 



I TYPICAL 
| FILE 
I ENTRY 
I 



(separated by "EOF's) 
STORE FORMAT 



HEADER 
kO WDS. 



1 

! 

/ NOTE: NO EOF. 
\ 



VOLUME 
DIRECTORY 



FILES 
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END OF VOLUME 



XXXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXXXX 



<FILES> 
(separated by "EOF's) 



"STORE/RESTORE LABEL -HP/3000. " 



FLAG: PRECEDING EOF MARKS FILE ENDED 



FLAG: PRECEDING EOF MARKS TAPESET ENDED 
VOLUME NO. 



DATE 
TIME 



EOF 



xxxxxxxxxxxxxxxxxxx eof xxxxxxxxxxxxxxxxxx 
XXXXXXXXXXXXXXXXXXX EOF xxxxxxxxxxxxxxxxxx 




13 

lit 

20 
21 
22 

23 
2k 

25 
26 

27 

39 



FILES 



TRAILER 
1*0 WDS. 
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CHAPTER 17 MISCELLANEOUS 



LABELeu tafe subsystem 

The MPE labeled tape subsystem permits convenient access to tapes 
labeled to either ANSI or IBM standards. It operates as a set of 
subprocedures to the file system. 

A labeled tape consists of one or more logical files. Each logical 
file consists of three physical files, i. e. tape areas delimited by 
tapemarks. The first physical file contains header labels, the second 
contains the data, and the third contains trailer labels which are 
(except for minor differences) copies of the header labels. The tape 
mark following trailer labels will be followed either by header labels 
for the next file, or by another tapemark if there is no next file. 



Format of MPE Tape Labels 



Labels are 80 bytes long, and conventionally are identified by their 
first four characters (three letters and a digit) and contain 
information as follows (CP := character position; L:= length): 

V0L1: Present only on the first file of a volume, the volume label 
contains the volume identifier, which is usually the number on the tape 
strap, and is thus not expected to be changed. 



CP i Field Name j L \ Content 


1/3 1 Label identifier | 3 1 "VOL" 


U | Label Number | 1 | "1" 


5/10 | Volume Identifier | 6 | Vol ID 


11 | Accessibility | 1 | "0" if IBM, else " " 


12/79 1 Not used | 62 | Blanks 


80 | Label-Standard Version | 1 | "1" if H-P ANSI else " " 



UVLn: User volume labels. May be present on tapes from foreign shops, 
but are not written by MPE. If encountered, they are ignored. 
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HDR1: First header label. Required for each file. Specifies: 



| CP ! Field Name | L | Content 


| 1/3 I Label identifier | 3 1 "HDR" 1 


| U | Label Number | 1 | "1" I 


|| | | File name, if tape was not | 
| 5/21 | File Identifier j 17 1 written by MPE, only the j 
|| 11 first eight are significant.! 


| 22/27 1 Volume Set Ientifier | 6 | Names the volume on which | 
|| || the set of files begins | 


j 28/31 j Reel Number j k j Counts the reels that j 
|| || contain this file (1 starts )| 


1 32/35 1 File sequence number | k | Counts the files in the set | 
|j | j of files (1 starts) 


| 36/Ul | Not Used i 6 | MPE writes blanks j 


j U2/U7 1 Creation Date | 6 | Year and day within year | 
|| || when the file was written. | 


|| || Tear and day within year | 
1 U8/53 1 Expiration Date | 6 | when the file may be over- | 
|| || written without permission. | 


| 5 1 * 1 Accessibility | 1 | %230 if Lockword, "0" if IBM| 


j 55/60 j Block count j 6 j Number of blocks if IBM. j 


I 61/73 1 System Code | 13 | "HP MPE 3000 " | 


| 7U/80 | Not Used | 7 1 Blanks | 
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HDR2: Second header label, 
missing on foreign tapes. 



Although defined by the standard, may be 
Contains : 



CP 


Field Name 


L 


Content j 


1/3 


Label identifier 


3 


"HDR" j 


k 


Label Number 


1 
1 


"2" I 


5 


Record Format 


"F" = Fixed I 
"V" = Variable | 
"U" = Undefined | 
Others treated as Undefined | 


6/10 


Block Length 


5 


Block length (in character | 
format ) . 1 


11/15 


Record Length 


5 


Record length (adhering to ! 
to MPE rules ) in characters . | 


16/23 


Lockword 


8 


MPE File Lockword. | 


2U/36 


Not Used 


13 


MPE writes blanks | 


37 


Record Type 


1 


!! A !! = ASCII i 
"B" = Binary. j 


38 


Carriage Control 


1 


"C" = control | 
" " = no control. | 


39/80 


Not Used 


1*2 


Blanks ! 

« 
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IBM: IBM has a slightly different format. It is: 

» 



CP 


Field Name 


L 


Content 


1/3 


Label identifier 


3 


"HDR" 


U 


Label Number 


1 


ii-n 


5 


Record Format 


1 


"F" = Fixed 

"V" = Variable 

"U" = Undefined 

Others treated as Undefined 


6/10 


Block Length 


5 


Block length (in character 
format). 


11/15 


Record Length 


5 


Record length (adhering to 
to MPE rules) in characters. 


16 


Not Used 


1 


Blank. 


IT 


IBM Position 


1 


"0" = no volume snitch 

"1" = a switch has occurred. 


18/38 


Not Used 


11 


Blanks . 


39 


IBM Block Attribute. 


1 


"B" = Blocked records. 
"S" = Spanned records. 
"R" = Blocked and Spanned. 
= No blocked or spanned. 


UO/80 


Not Used 


Ul 


Blanks 



# 
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User header labels: optional. Standard prescribes UHLn in the first 
four characters, but MPE doesn't care. 

E0V1: End of Volume; used as first trailer label. Required if the 
logical file is continued onto another reel. Identical to HDR1, except 
contains the number of physical blocks of data in the data area. 



*__, 



.____» 



CP 


Field Name 


L 


Content 


1/3 


Label identifier 


3 


"EOV" 


U 


Label Number 


1 


ii. it 


5M 


Same as HDR1 


50 




55/60 


Block Count 


6 


Number of data blocks since 
last beginning of file 
section label group. 


61/80 


Same as HDR1 


20 





E0V2: Defined by the standard, but may be missing on foreign tapes. 
Follows E0V1; format same as HDR2. 

E0F1: End of File; used as first trailer label. Required if this is 
the end of the logical file. Format same as E0V1. 

E0F2: Same as EOV2 except used after E0F1. 

User trailer labels: optional. Standard prescribes UTLn in the first 
four characters, but MPE again doesn't care. 
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TAPE LABEL TABLE 

The tape label table is the private playground of the tape label 
subsystem. It consists of two parts: LDEV Control Blocks (LCBs) and 
Volume Control Blocks (VCBs). The LDEV area is set up at system 
initialization and contains one entry for each magnetic tape 
LDEV and serial disc device in the system. As is common in MPE, the 
first entry is a dummy which tells where the other things in the table 
are. The volume area contains one entry for each labeled tape volume 
requested or active on the system. 

Although table entries are stored in an extra data segment, 
they are generally manipulated via local copies on the stack. The 
procedures GETLDEV and GETFNUM look for LDEV and volume entries as 
specified; they copy them to stack buffers and return the DST address 
for use in copying them back. POSTVTENT copies the entries back, and 
in the case of a new volume entry, allocates space for it in the 
volume section of the tape label table. 



Tape Label Table Header Entry 



During PROGEN, SETUP'TAPES is called to initialize the table. 
The overall structure of the initialized TLT is: 

TLTDST -- %32,#26 TLTSIR — #*7,#39 

1 2 3 h 5 6 7 8 9 10 11 12 13 lU 15 

Table initialization word (=1 when initialized) 




1 
2 
3 
h 

5 
6 

7 
10 



Entry size (ESIZE) = %32,#26 
Table relative pointer to base of LCB entries (LTBASE) (1) 



Table relative pointer to base of VCB entries (VTBASE) (2) 
Table relative pointer to top of Volume table (VTTOP) (3) 
Size of Tape Label Table, in words (VTMAX) 



not used 



30 

31 
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I I 32 

I I <-(l) 

LDEV Control Block area -- one entry /mag tape drive 

i_ - i 

i <-(2) 
I I 

Volume Control Block table -- contains VCB entries 

and free entries 

I - ! 

! I 



Unintialized Table (INITIAL) 

INITIAL will build the "uninitialized" TLT as follows: 
l 2 3 k 5 6 7 8 9 10 11 12 13 l 1 * 15 

I Size of the table, in words (always > 1) I 

| — " " I 

Number of LDEVS in the table = X ! 1 

i ------ -I 

j LDEV# j |T i 2 

! ! 

Total of LDEVS (X) entries of above 



| I 

| LDEV# | |T | X+2 

! ! 

Expansion area 

during SETUP 'TAPES 



T: 1 if Tape drive 

if not Tape drive (ie. serial disc) 
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LCB Entry Format 

The LCB entries have the following structure: 

1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

Type | T | L | B | HP | | 

Logical device number I 1 

VCB address j 2 

Reel number I 3 

File sequence number | U 

Creation date | 5 

Expiration date I 6 

7 

File name I 10 



16 

17 
20 
21 
22 
23 
2U 

Volume set identifier | 25 

26 

27 

Volume identifier | 30 

31 



(not used) 
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Type: 00 = no tape mounted 
01 = unlabelled 

10 = ANSI 

11 = IBM 

L: 1 if file has lockword. 

T: 1 if device is a tape drive. 

B: 1 if tape is from Burroughs, which has incorrect block/record size 

in the HDR2 label. Code can be patched to correct the size. 
HP: 1 if tape is Hewlett-Packard ANSI format. 

VCB address: Pointer to VCB entry describing volume mounted on 
tape drive, only if linked. Otherwise, 0. 
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VCB Entry Format 

The VCB format is: 

1 2 3 k 5 6 7 8 9 10 11 12 13 lit 15 

A | F | D | Position | W | SeqTypI LblTypI L | M | R | B | 

LDEV # | 1 

PIN | 2 

File number (AFT index) j 3 

File sequence number j k 

S | R | D | C | Density | V | Reel number | 5 

Expiration date j 6 



7 
File name I 10 



16 
I I 17 



Lockword 



20 
21 
22 
23 
2k 

Volume set identifier | 25 

26 

27 
Volume name | 30 

31 
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BREAK POINT TABLE 
DST = 30(10) = %36 
The break point table is divided into 2 sections: 

1) PCB BREAKPOINT EXTENSION TABLE (PCB'BKPT'EXT) 
This table contains the heads of the breakpoint 
chains 

2) BREAKPOINT ENTRY TABLE (BKPT 'ENTRY 'TAB) 
This table contains .the actual entries 

General Layout 



PCB(7).(8:8) 
I i — - 



j PCB'BKPT'EXT 

I 
I 

I 



• > 



! ! 
I i 
I I 



I ! 

| j BKPT 'ENTRY 'TAB 



I I 



SYS GLOBAL 

lU:15 



%11 | :L:S| | | 



S = System break | 

points exist | | 1 



--> 
i 
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PCB BREAKPOINT EXTENSION TABLE 



I # ENTRIES | 


ENTRY SIZE = 
FREE ENTRY = 
ACTIVE ENTRY 


1 


I HEAD SYSTEM LIST | 





I # USED USER ENTRIES | 


= Index 1st Entry 


USER ENTRIES 


in breakpoint 
chain 
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BREAKPOINT ENTRY TABLE 







ENTRY (0) 






FREE ENTRY 







l# 
1 


WORDS BREAKPOINT TAB 
HEAD FREE LIST 


1 
1 


|1: 


SIZE 




1 




FORWARD LINK 




2 


1 

1 
1 
1 
1 


UNUSED 


1 
1 
1 
1 
1 




BACKWARD LINK 




3 


~ 




- 






LAST ENTRY 









1 




11 









The breakpoint entry table consists of variable length entries 
The minimum entry size is 5- 

ACTIVE ENTRY 

0|l:2:3|U:5:6|7:8:9l0:l:2|3:U:5 



o 


0|P:L:V|D:F:T|U:P:C|U: 
| : : | : : I :M: |P: 


SIZE | 




1 


BLOCKLABEL 




2 


PLOC 




3 


INSTRUCTION 




U 


LINK 






USERLABEL 


• 




CONDITION/COUNT 


variable 




| COND DESCRIPTOR 


4 
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BREAKPOINT ENTRY TABLE (CONT.) 



ENTRY(O) . ( 


ENTRY(0).( 


ENTRY(0).( 


ENTRY(0).( 


ENTRY(0).( 


ENTRY(0).( 


ENTRY(0).( 


ENTRY(0).( 


ENTRY(0).( 


ENTRY(0).( 


ENTRY(0).( 


ENTRY(U) = 



0:1 
1:1 
2:1 

3:1 
U:l 



= FR: 
= P: 
= L: 
= V: 
= D: 

5:1) = F: 

6:1] 

7:1) 

8:1] 

9:1] 

10:1) = UP: 

= LINK: 



= T: 



= U: 



= PM: 



= C: 



FREE ENTRY 
1 = FREE 

= USED 

PRIVILEGED MODE BREAKPOINT 

1 = PRIV. 

= NON-PRIV 
PROCESS-LOCAL BREAKPOINT 

1 = PROCESS-LOCAL 

= SYSTEM 
VALIDATION BIT 

1 = INSTRUCTION IN ENTRY(3) 

= INSTRUCTION NOT IN TAB. 
DOUBLE TRAP 

1 = BREAKPOINT OSCILLATES BETWEEN 

P/P+l 

= NOT DOUBLE TRAP 
FAKE 'DUMMY' TRAP 

1 = BREAKPOINT AT P+l 

= BREAKPOINT AT P (ORIG. LOC) 
TWO WORD INSTRUCTION 

1 = TWO WORD INSTRUCTION 

= NOT TWO WORD INSTRUCTION 
USER LABEL PRESENT 

1 = TRAP TO USER SUPPLIED LABEL 

= TRAP TO DEBUG 
PERMANENT BREAKPOINT 

1 = PERM 

= TEMPORARY 
CONDITION/COUNT 

1 = CONDITION/COUNT SPECIFIED 

= NO COND/COUNT 
UPDATING 

1 = ENTRY IN PROCESS OF BEING 

UPDATED/REMOVED 
= NOT BEING UPDATED /REMOVED 
LINK 

= END OF CHAIN 
>0= INDEX NEXT ENTRY 



17-1*+ 



BREAKPOINT ENTRY TABLE (CONT.) 
COUNT CONDITION 

1) j ORIGINAL CNT. i 2) i OPERANDI | 
| # OF HITS i i OPERAND2 I 
j 1 | jOPTljOPt2i RELOP | 



RELOP -> (8:8) RELOP NUMBER: 

3 = LT 9 = LTE 
U = GT 10 = GTE 
5 = EQ 11 = NEQ 
OPT1 -> (0:2) OPERANDI 'S TYPE 
OPT2 -> (2:2) OPERAND2'S TYPE 

OPERAND TYPES: 

-> CONSTANT (SINGLE WORD) 

1 -> ADDRESS (DOUBLE WORD) 

3 -> INDIRECT ADDRESS (TRIPLE WORD) 



OPERAND FORK 
CONSTANT 


IS: 

-> 

-> 

-> 
-> 




| CONST | 


ADDRESS 




| REG | BASEl 




| OFFSET | 




jlND. OFFSET) (TYPE 3 ONLY) 


REG 
BASE 


(0:6) CORRESPONDING INDEX INT 
3 = A 10 = DL 
U = SY 11 = Q 

7 = DA 12 - S 

8 = DX 17 = EA 

9 = DB 
(6:10) SEG #/BANK # 
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TIMER REQUEST LIST (TRL) 



The system clock interrupts every 100 ms, with the CR being 
automatically cleared. An exception is the Shared Clock 
Interface measurement service which allows rates as fast as 5 ms. 
The interrupt handler is the procedure TICK. On entry, DB is 
pointing to the base of timer request list. Besides timeout 
requests, the clock also controls time slicing. 



/ 

I 

I 1 
ENT0| 

I 2 
I 
\ 3 

/ k 

I 

I 5 
I 
ENT1| 6 

I 
\ 7 

/ 8 

I 
I 9 



ENT2| 



1 10 

I 

Ml 

/12 

I 
1 13 



ENT3| 



FREE LIST PTR 
NR ENTRIES | ENTRY SIZE(U) 



TRACE WORD 

# of days since last start 

QUANTUM/100 ms 



TIME OF DAY* 



YEAR | JULIAN DAY 
PTR TO MOST ACTIVE REQUEST 









A| CODE | PTR TO NEXT 
REQ 



TIME TO SERVICE AFTER 
REQUEST IN FRONT (UNIT= 100ms) 



A: if inactive request 
1 if active request 



Series 30/33 only 
QTIME 

DTIME* 



HEAD 



dummy time 



I 
I 

assignable 
entries 



17-16 



TRL (CONT.) 



CODE S: REQ indicate the type of request , 



CODE: 


REQ: 


TYPE: 





DITP 


Hangup 


1 


DITP 


Carrier failure 


2 


DITP 


202 turnaround 


3 


DITP 


Read 


1* 


DITP 


Logon 


5 


PCBB index 
to process 


Delay 


6 


DITP 


LP not ready 


7 


DITP 


26U0 


%10 


Port mask 


Msg port timeout 


5111 


DITP 


Block mode read 
timeout (30 sees) 


%12 


PCBB index 


Watchdog timer for 




to process 


process 



The list of pending requests is kept ordered hy time with later 
entries at the tail. 



#20-5t37 



DITP 



SIO device timeout: 
DIT8. (code_l on 
exp irat ion , c leared 
on Timereq. 



%5/%6 



»DTIME 



For Series 30/33, DTIME is 
# of TICS (0.091U57 ms) 
since last midnight. 
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MPE USER LOGGING 



MPE USER LOGGING enables users and subsystems 
to log changes to data sets on disc or serial files. 
This "change" file can later be used to recover 
data lost due to a system or program failure. The 
log file can itself be used for auditing purposes. 



GENERAL DESIGN OVERVIEW 

A. Hardware Environment 

No special hardware is required to operate the 
system . However, if logging to a tape file is 
desired, the hardware configuration must include 
a tape drive. 

If there is no tape drive, then may log to a serial 
disc class device. 

B. Software Environment 

MPE USER LOGGING is an integral part of MPE. 
No other special software is required. 

C. Design Narrative 

User Logging enables users and subsystems to 
journalize additions and modifications to MPE 
and subsystem files. The journal can reside on 
either disc or serial logfiles. 

User Logging consists of a logging process, a memory 
buffer, a disc resident logging buffer (for serial 
logging) and a user defined destination log file on 
disc or serial media. 

The logging process has two functions depending on 
whether the destination file resides on disc or 
serial media. If the destination file is serial, the 
logging process performs all output to the 
destination file. If the destination file is on 
disc, the logging process allocates additional 
space (extents) as it is required by the user. 

The logging buffer is divided into communication 
and buffer areas. The communication area is used 
to pass information among the users and the logging 
process. This information includes status of the 
logging process and logging file, space remaining 
in the logging file and error information important 
to users or the logging process. The buffer 
portion of the logging data segment blocks inputs 
into the logging file before the data is actually 
posted. The buffer is flushed any time a user 
requests to close a log file or when a logging process 
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is terminated. (The buffer is also flushed by the 
begin/end transaction or buffer flush requests). 



D. Error Recovery Description 

The error recovery mechanisms provided by User 
Logging are: power fail recovery and recovery from 
system failure. 

Power failure recovery applies only to tape log 
files since MPE provides adequate recovery for disc 
files during power fail. When a power failure 
is detected, a message will be printed on the 
console asking the operator to place the tape drive 
back on-line. (If the operator places the tape on-line 
before the message valid data may be overwritten) . 
(To reset the tape drive the operator must hit the 
load button until the tension returns to the drive. 
Then hit the reset button followed by placing the 
tape drive back on-line). 

At this time the log process will recover the file by 
rewinding to the load point and then 
forward spacing to the point where the power 
fail occured. Writing to the log file will 
continue at that point. 

In the event of a system failure, the warm start 
load option initiates recovery of User Logging 
files. In the case of a serial file, the file is 
read and compared to the disc logging buffer. 
All records found in the disc buffer that 
are not on the serial log file are posted 
and a proper end of file written. If the 
destination file is a disc file, all records are 
read and verified and an end of file posted to the 
file. In order to continue logging to a User 
Logging file that has been recovered in this 
manner, the logging process for the file must 
be restarted using the console command :LOG. 

NOTE: 

Any records in the buffer area of the logging 
buffer will be lost. 

User logging has been enhanced to work with 
labeled serial discs. Internally the log process 
handles serial disc (or cartidge tape) log files 
the same as for tape files. 
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II. DESIGN STRUCTURES 

A. USER LOGGING TABLE 

ENTRY SIZE = #38 words 
DST %33 



Table containing an entry for each activated user logging process. 
Each entry is created when the process is started, and deleted 
when the process terminates. (Via :LOG command). The information 
is extracted from the Logging Identifier Table (LIDTAB) . 



ENTRY 



# 


1 
2 
3 
U 

5 
6 

7 
37 



NUMBER OF ENTRIES 



FREE ENTRY HEAD FT. 



INUSE ENTRY HEAD PT. 



NEXT BUFFER NUMBER 



MAX # PROCESSES 



MAX # USERS/PROCESS 



ENTRY SIZE 



% 

1 
2 
3 
U 

5 
6 

7 
1*5 



WORD ENTRIES 

NUMENTRIES 

FREE 

INUSE 

BUFNUM 

MAXLOGPROC 

MAX'USR'PROC 

LOGTAB'ESIZE 



LOGTAB 
LOGTAB(l) 
LOGTAB (2) 
LOGTAB (3) 
LOGTAB (U) 
L0GTAB(5) 
LOGTAB (7) 
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NUMENTRIES 

The number of entries in the logging table. 

FREE 

A table relative pointer to the first free entry in the logging 

table. (-1 = table full). 

INUSE 

A table relative pointer to the first entry in the logging table 

that is being used (-1 = no entries in use). 

BUFNUM 

The number of the buffer associated with this logging process. 
Used to create the name of buffer file if serial logfile. 
(i.e. ULOGxxxx.PUB.SYS). 

MAXLOGFROC 

The maximum number of user logging processes allowed. 

MAX'USR'PROC 

The maximum number of users per logging process. 

LOGTAB'ESIZE 

The size (in words) of each entry in the table. 
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# 





12 



16 



20 



TYPICAL ENTRY 



LOGGING 
IDENTIFIER 



BUFFER 
NAME 



FILE 
NAME 



LOCK 
WORD 



GROUP 



ACCT 



% 




10 



1U 



20 



2k 



2U 

25 
26 



NUMBER OF USERS 



BUFFER DST NO 



LOG STATUS 



30 
31 
32 
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27 


CURR AUTO | CURR TYPE 


33 


28 


LOG DEV 


3U 


29 


LOG PCB # 


35 


30 


SWITCH FLAG 


36 


31 


HEW AUTO | NEW TYPE 


37 


32 


ADDRESS OF 
LOGGING BUFFER 


1*0 


3*» 


SIZE OF 
LOGGING BUFFER 


U2 


36 


FWRD ENTRY PT 


kli 


37 


BWRD ENTRY PT 


k5 



TABINDEX 

BTABINDEX 

DTABINDEX 



WORD INDEX TO CURRENT ENTRY 
BYTE INDEX TO CURRENT ENTRY 
DOUBLE INDEX TO CURRENT ENTRY 



LGNAME 

BNAME 

LFNAME 

LFLOCKW 

LFGROUP 

LFACCT 

NUHUSERS 

DST 

STATUS 

LGAUTO 

LGTYPE 

LGDEV 

PIN 

LGSWITCH 

LGNEWAUTO 

LGNEWTYPE 

LGADDR 
BSIZE 



BTABINDEX 

BTABINDEX-i-8 

BTABINDEX+16 

BTABINDEX+2U 

BTABINDEX+32 

BTABINDEX+UO 

TABINDEX+2U 

TABINDEX+25 

TABINDEX+26 

TABINDEX+27.(0:8) 

TABINDEX+27.(8:8) 

TABINDEX+28 

TABINDEX+29 

TABINDEX+30 

m * n T VTM.i g ill f f\ . Q \ 

TABINDEX+31.(8:8) 

DTABINDEX+16 
DTABINDEX+17 



NEXT 
PREV 



TABINDEX+36 
TABINDEX+37 
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LGNAME 

The name of the lpgging process (logging identifier). 

BNAME 

The name of the disc buffer used if the logging process 
destination file is a serial file. This is a file that resides 
in PUB. SYS. The format of the name is ULOGxxxx where xxxx is the 
buffer number padded on the left with zeroes. 



If the switch flag is true, the following will be the fully qualified 
file name of the new log file. 

LFNAME 

The name of the logging file. 

LFLOCKW 

The lockword of the disc logging file. 

LFGROUP 

The group that the destination logging file resides in if the 

file is a disc file. 

LFACCT 

The account that the destination logging file resides in if the 

file is a disc file. 

NUMUSERS 

The number of users currently accessing the logging file. 

DST 

The dst number of the logging data segment (LOGBUFF). 

(-1 = LOGBUFF not created yet) 

STATUS 

The status of the logging process. 

ACT = 1, INACT = 0, RECOVERING = 2, INITIALIZING = -1. 

LGAUTO 

True if the automatic changelog facility was enabled. 

LGTYPE 

The type of destination file of the logging process. 
DISC = 0, TAPE = 1, SDISC = 2, CTAPE = 3 

LGDEV 

The logical device number of the disc logging file or the 

disc logging buffer. 

PIN 

The PCB number for the logging process. 

LGSWITCH 

Flag indicating a CHANGELOG is pending (if true). 

LGNEWAUTO 
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True if the automatic changelog facility was requested for the new 
log file. 

LGNEBTTPE 

If a switch is pending, this will be the type of the new log process. 

(-1 - no switch pending) 

LGADDR 

Sector number of the current extent in the disc logging file or 

the disc buffer file. (Disc buffer file has only 1 extent) 

BSIZE 

The number of records in the current extent (for disc logging) or 

the number available in the disc logging buffer. 

NEXT 

A table relative pointer to the next entry in the logging table. 

(-1 = this is last entry) 

PREV 

A table relative pointer to the previous entry in the logging 

table. (-1 » this is first entry) 
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B. USER LOGGING BUFFER 



There will be one of these tables around for the life of any 
active user loggging process. The table consists of three parts: 



COMMUNICATIONS AREA - 



Info about status of the process, etc. 
that is common to all users of the process. 
Also the cells for messages to/from the 
process. 



USER ENTRIES 



BUFFER AREA 



Info for a specific user of the process. 
One of these for every user of a process 
(Setup by OPENLOG, released by CLOSELOG). 

Buffer used to hold logging records from 
all users before writing to the log file. 





COMMUNICATIONS 


AREA 










I ENTRY #2 








|FPT|BPT| 
1 1 1 


I ENTRY #3 








|FPT|BPT| 
1 1 ! 


| ENTRY tk 








|FPT|BPT| 
1 1 i 


\ • 










] ENTRY #N 








|FPT|BPT| 
1 1 1 


j BUFFER AREA 
| kK WORDS 
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COMMUNICATIONS AREA 






LOGGING 
IDENTIFIER 





k 


SWITCH FLAG 


1+ 


5 


NEW AUTO | NEW TYPE 


5 


6 


AUTO | TYPE 


6 


7 


BUFFER DST 


7 


8 


LOG PIN 


10 


9 


NUMBER OF USERS 


11 


10 


MAX NUMBER OF USERS 


12 


11 


NEXT USER NUMBER 


13 


12 


SLEEP COUNT 


Ik 


13 


STATE 


15 


lU 


MSG 


16 


15 


LOG MSG 


17 


16 


USER MSG 


20 


17 


LOG ERROR 


21 


18 


LOG DEVICE 


22 


19 


BUFFER SPACE 


23 


20 


USED SPACE IN BUFFER 


2k 


21 


FILE SET NUMBER 


25 


22 


LOG 
ADDRESS 


26 


2k 


INPUT 
RECORD 


30 






| f JLbCi 

USER LOGGING BUFFER (CONTINUED) 



3£ 
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28 
30 
32 

3U 

35 
36 

38 



SIZE 
FILE 
SPACE 



TOTAL 
RECORDS 



MAX 
SIZE 



LAST EXTENT 



EXTENT 



RESOURCE 



3U 

36 

UO 

1*2 
U3 
1*1* 

U6 



U8 
*9 



IN USE HEAD PTR 



FREE HEAD PTR 



60 

61 
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LOGID 



BLOGBUFF(O) 



SWITCH' 

NEWAUTO 

NEWTYPE 

AUTO 

LOGTYPE 

BDST 

LOGPIN 

NUMUSER 

MAXUSER' 

USERNO 

SLPCT 

STATE 

HSG 

LOGMSG 

USERMSG 

LOGERR 

LOGDEV 

BSPACE 

BUFUSED 

VSETNO 

LOGADDR 

INBUFREC 

FSIZE 

FSPACE' 

TRECS 

MAXFSPACE 

LASTEXT' 
EXTENT 

RESOURCE 

UHEAD 
FHEAD 



LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 
LOGBUFF 



(U) 

(5). (0:8) 

(5). (6:8) 

(6). (0:8) 

(6). (8:8) 

(7) 

(8) 

(9) 

(10) 

(11) 

(12) 

(13) 

(1U) 

(15) 

(16) 

(17) 

(18) 

(19) 
(20) 
(21) 



DLOGBUFF(ll) 
DLOGBUFF(12) 
DLOGBUFF(13) 
DLOGBUFF(lU) 
DLOGBUFF(15) 
DLOGBUFF(l6) 

LOGBUFF (3*0 
LOGBUFF (35) 

DLOGBUFF(lS) 

LOGBUFF (U8) 
LOGBUFF (U9) 
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LOGID 

The name of the logging process. 

SWITCH' 

True if log file switch is pending. 

NEWAUTO 

True if the automatic changelog option has been specified for the 

new log file. 

NEWTYPE 

If a switch was requested, this will be the type of the new logging 

file. (-1 = no switch pending) 

AUTO 

True if the automatic changelog option was specified for the current 

log file. 

LOGTYPE 

The type of destination file for the logging process. 

DISC = 0, TAPE = 1, SDISC = 2, CTAPE = 3 



The data segment number of this table. 

LOGPIN 

This is the PCB number for the logging process (PIN*l6). 

NUMUSER 

The number of users currently accessing the logging file. 

MAXUSER' 

The maximum number of users allowed to access the logging file. 

USERNO 

The next sequential number to be assigned users accessing the 
system. It will get incremented for every unique OPENLOG - used 
as the log # in the logging record format. 

SLPCT 

The number of users currently waiting for activization by the 

logging process. 

STATE 

The state of the user logging process. 

ACTIVE = 1, INACTIVE = 0. 

MSG 

An internal messge word used to indicate an error or operator 

request . 

6 - Continue processing, all o.k. 

2 - Suspend - error reading buffer file or writing to serial file 

3 - Stop - set when issue :L0G logid,ST0P or when an EOF 

condition is found on the disc log file. 
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LOGMSG 

A messages from the logging process. 
6 - Continue processing, all O.K. 
15 - EOF - if there are no more extents available to be 

allocated. 
12 - Disc space - could not allocate the new extent because 
no space left in the group. 
9 - Write error - error occurred while writing to log file 

USERMSG 

A messages from the user process. 

6 - Continue processing, all O.K. 
12 - Disc space - user process needs another extent allocated 
for disc logging. 

LOGERR 

Last error found. 

After change log: 

+N - File System error number encounterd 
- No error 

-1 - New disc log file was not empty 

-2 - New disc log file did not have file code LOG 

-3 - New disc file is too small 

LOGDEV 

The logical device number of the current extent of the disc log 

file or the disc buffer file (buffer file has only 1 extent). 

BSPACE 

The amount of space, in records, that are currently available to 
the users. On the last block of the last extent, one record will be 
saved by the logging process so that the proper close information 
can be posted to the file - either the trailer record (if the log 
logging process is stoppped) or the change' to 'new record because 
of an EOF condition (and the AUTO option had been specified). 

BUFUSED 

The number of records currently in the buffer. On all extents, 
except the last extent BUFSPACE+BUFUSED = 32 (number of records 
in a complete block). However, on the last block of the last 
extent this will NOT be true since one record is always held in 
reserve by the logging process. 

VSETNO 

This shows the order in the log file "set" of the currently opened 

log file. 

LOGADDR 

The disc address of the current extent of the disc log file. 
If it's a serial file, this is the disc address of the 
disc buffer for the file. 

INBUFREC 

The record number of the next block to be written to the logging 
destination file or the disc logging buffer for serial files. 
(Used as an offset into the current extent for the writes - since 
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each record is one sector in length) . 

FSIZE 

The current extent size of the logging destination file or disc 

logging buffer file for serial destination files. 

(on the last extent this will be the last extent size minus 1). 

FSPACE' 

The space in records that remains in the current extent of the 
disc logging destination file or disc buffer for tape destination 
files. (On the last extent of the disc log file, this is the 
amount of space minus 1) . 

TRECS 

The total number of records written to the logging destination 

file (including those records currently in the buffer). 

HAXFSPACE 

The total file size, in records, minus 1. (Need that last record 

to post close information) . 

LASTEXT' 

The extent number of the final extent in the disc logging file or 

disc buffer file. 

EXTENT 

The current extent number of the disc logging file or disc logging 

buffer. 

RESOURCE 

Used for resource management (i.e. locking the LOGBUFF). 

Format is: 

RESOURCE. (0:8) = Owner's pin, RESOURCE. (8:8) = Queue length, 
RESOURCE1.(0:8)= Q tail pin, RESOURCE1. (8:8)= Q head pin. 

UHEAD 

A table relative pointer to the first entry into the logging 

data segment. (-1 = no entries currently in use) 

FHEAD 

A table relative pointer to the first free entry in the logging 

data segment. (-1 = no free entries) 
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# 





8 



12 
13 
Ik 

15 
16 
17 
18 



23 

2k 



TYPICAL LOGBUFF ENTRY 



USER 
NAME 



GROUP 
NAME 



ACCOUNT 
NAME 



USER PCB # 



OPENLOG COUNT 



WAIT STATE 



ERROR CODE 



LOG NUMBER 



SUBSYSTEM CODE 



TOTAL 
RECORDS 



FRWD ENTRY PTR 



BKWRD ENTRY PTR 



% 




10 



Ik 

15 
16 

17 
20 
21 
22 



27 
30 
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BINDEX = BYTE INDEX TO CURRENT ENTRY 

INDEX = WORD INDEX TO CURRENT ENTRY 

DINDEX = DOUBLE INDEX TO CURRENT ENTRY 

USER = BINDEX 

GROUP = BINDEX+8 

ACCT = BINDEX+16 

UPIN = INDEX+12 

OPENCNT = INDEX+13 

WSTATE = INDEX+lfc 

ERROR = INDEX+15 

LGNUM = INDEX+16 

SCODE = INDEX+17 

RECS = DINDEX+9 

NENTRY = INDEX+23 

PENTRY = INDEX+2U 



USER 

The name of the user who opened the logging file through this 

entry. 

GROUP 

The group of the user who opened the logging file. 

ACCT 

The account of the user who opened the logging file. 

UPIN 

The process identification number for the user's process. 

OPENCNT 

Counter of how many times this user called OPENLOG. (Incremented 

for every OPENLOG, decremented for every CLOSELOG). 

WSTATE 

The wait status of the users process. 

ACTIVE = 1, INACTIVE ■ 0. 

ERROR 

Used to hold error information for this user. 

= O.K. -1 = no room in disc (or disc buffer) and NOWAIT. 

LGNUM 

The logging number assigned to the user. 

(From USERNO in global area to be used as log # in the log record). 

SCODE 

The subsystem code for the caller. This applies only to 

privleged callers. 

RECS 

The number of records written by this user. 
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NENTRY 

A table relative pointer to the next entry in the logging data 

segment. (-1 = this is the last entry) 

PENTRY 

A table relative pointer to the previous entry in the logging 

data segment. (-1 = this is the first entry) 



C. LOGGING IDENTIFIER TABLE 

ENTRY SIZE = #33 words 
DST %kl 



Table containing an entry for each potential logging process. Entries 
are added via :GETLOG and released via :RELLOG. 



ENTRY #0 



# 


1 
2 
3 

32 



MAX NUMBER OF ENTRIES 



ENTRY SIZE 



% 

1 
2 

3 
k 



ENTRIES 



MENTRIES 
ENTRYSIZE 



LIDTAB(l) 
LIDTAB(ll) 



MfcTIUM'W I ta'S: 



The maximum number of entries in the table, (i.e. maximum number 
of user logging processes. 1 entry for every process - activated 
or not ) . 



ENTRYSIZE 

The size of each entry in the table. 
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# 





12 



16 



20 



2k 



TYPICAL ENTRY 



LOGGING 
IDENTIFIER 



PASSWORD 



FILE 
NAME 



FILE 
LOCK WORD 



FILE 
GROUP 



FILE 
ACCOUNT 



USER'S 



% 




10 



lit 



20 



2l» 



30 
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28 



32 



NAME 



USER'S 
ACCOUNT 



LOG TYPE 



3U 



i+0 



BYTE ENTRIES 

LID 

PW 

FNAME' 

LW 

FGROUP 

FACCT 

UNAME 

UACCT 



BLIDTAB 
BLIDTAB (8) 
BLIDTAB (16) 
BLIDTAB (2U) 
BLIDTAB (32) 
BLIDTAB (UO) 
BLIDTAB (U8) 
BLIDTAB (56) 



WORD ENTRIES 
TYP 



LIDTAB(32) 



LID 

The logging identifier name. This is a maximum of eight 

characters long. 

PW 

The pass word for the logging identifier. This is a maximun of 

eight characters long. 



Tha frtl 1 AMinff to +Vi<» fill 1*7 miaHfiaH fil* nana *s 

FNAME' 

The name of the destination file. 



■f +>»a /Mir»T»en+ n />of ♦"tIa 



gn+ lOET 



LW 

The lock word on the destination file if the file is on disc. 

FGROUP 

The group that the file resides in. 



17-37 



FACCT 

The account that the destination file resides in. 

UNAME 

The name of the user who created the logging identifier. 

UACCT 

The account of the user who created the logging identifier. 

TYP 

The status of the entry. -1 = null entry 

= disc logging file 

1 = tape logging file 

2 = serial disc logging file 

3 = cartridge tape logging file 
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D. LOGGING RECORD FORMAT 

RECORD SIZE = 128 words 
USER AREA = 119 words 



LOG RECORD AT OPENLOG 
2 3^6 



11 12 



2h 



25 



±Z( 



1 I 1 i I I I I I I 

| rec# | cksum | code |time|date| logid|log#| creator |pcb | 

I I I II I I I I I. 



USER OR SUBSYSTEM/CONTINUATION LOG RECORD (from WRITELOG) 
2 3 U6789 



127 



I i I I I i I I 
I rec# I cksum | code 1 1 ime | date | log# | len | 

I I I I I I I I 



user area 



LOG RECORD AT CLOSELOG 
2 3^6 



11 12 



2k 25 



I I I I I II II 

rec# I cksum I code | time | date | logid|log#| creator |pcb | 

I I I I I I I I I 



127 128 



T 



CRASH MARKER 
2 3 



127 128 



I I I I I I 
I rec# I cksum | code 1 1 ime | date | 

I I I I I I 



I 



HEADER RECORD (START/RESTART) 
2 3 U 6 7 



11 



127 



i i 1 111 

I rec# I cksum I code | time | date | logid 

I I I I I I 
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TRAILER RECORD (STOP) 
2 3 k 6 



11 



I I I I I I I 
| rec# | cksum | code | time | date | logid | 

i I I I i I I 



127 



NULL RECORD 
2 3 



It 6 7 



rec# | cksum j code j time j date j 
I I I I I 



127 128 

— r~i 

I I 
I I 



BEGIN TRANSACTION MARKER 

2 3 1*6789 



127 

— I 
I 
I 



i \ i i I i i r 

I rec# I cksum I code | time | date |log#|len| 
I I I I I I I I 



user area 



END TRANSACTION MARKER 

2 3 U6789 



127 



I \ I I I I I T 

I rec# I cksum I code | time | date | log# | len | 

I I I I I I I I 



user area 



CODE DEFINITION 

CODE. (8:8) = 

1 Open log record 

2 User/subsystem record (writelog) 

3 Close log record 
k Header record 

5 Trailer record 

6 Restart record 

7 Continuation of a user or subsystem record 
9 Crash marker 

10 End transaction record 

11 Begin transaction record 
SPACE NULL record 



n-ko 



DATA FIELDS OF LOG RECORDS 



REC# 

CKSUM 

CODE 

TIME 

DATE 

LOGID 

LOG# 

LEN 

USERAREA 

CREATOR 

PCB 



DOUBLE INTEGER 

INTEGER 

INTEGER 

DOUBLE (from intrinsic CLOCK) 

INTEGER (from intrinsic CALENDAR) 

ASCII 

INTEGER 

INTEGER 

ASCII 

ASCII 

INTEGER 



NOTE: 

1. The checksum algorithm uses the exclusive or (XOR) function against 
a base of negative one. 

2. Null record is used for filler. 

3. The code word of the logging record can contain a subsystem 
code defined by the user in the first half of the word (0:8). 
User logging allows privileged users to pass this code in the 
index parameter of the Openlog intrinsic. 

h. The "len" field will contain the entire length of the data in 
the transaction (i.e. the length passed to WRITELOG, BEGINLOG, 
ENDLOG) . If a continuation record is part of the transaction, 
it will also contain the entire length of the data. For 
example, a length of lUO was passed to the intrinsic. The 
"len" field of the first record will be lUO, the "len" 
field of its continuation record will also be lUO - even 
though the actual amount of data found in the first record 
will be 119 and the data found in the continuation record 
will be 21. 
(Positive length = # words, negative length = # bytes) 
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MEASUREMENT INFORMATION TABLE (MEASINFOTAB) DST=59 (%J3) 





1 o 

I 1 

1 2 

3 
10 
It 

1 5 
1 6 

1 7 


| LDEV # OF MEASIO | 




| MEASIO PLABEL | 




| MEASIO DST # | 


Reserved 
for MEAS 
control 




















| 10 

11 

12 

13 

ice 

Ut 
~s 

15 

16 I 

17 1 








Reserved 

for 

performai 

tunning 

paramete] 




















20 I 

21 | 

22 | 

23 1 

2k | 

25 1 


GLOBAL STATISTICS XDS NUMBER | 




PROCESS STATISTICS XDS BANK | 




PROCESS STATISTICS XDS BASE | 




PROCESS STATISTICS XDS NUMBER | 




CLASS lU STATISTICS XDS BANK | 




CLASS lU STATISTICS XDS BASE | 



MEASLDEV 
MEASPLAB 
MEASDSTN 



MEASSTATX- 
DSNUM 

MEASPROC- 
XDSBANK 

MEASPROC- 
XDSBASE 

MEASPROC- 
XDSNUM 



n-k2 



MEASINFOTAB (CONTINUED) 



26 
27 
30 
31 
32 
33 
3U 

35 
36 
37 
Uo 
kl 
k2 

U3 
kk 

h5 



I 
reserved 
for 

HieaSUreiiien 1/ . 

interface 



fTrt 



51 
52 
53 
5U 



i CLASS 


Ik 


STATISTICS 


XDS 


NUM. | 


| CLASS 


13 


STATISTICS 


XDS 


BANK | 


I CLASS 13 


STATISTICS 


XDS 


BASE | 


| CLASS 


13 


STATISTICS 


XDS 


NUM. | 


| CLASS 


12 


STATISTICS 


XDS 


BANK | 


| CLASS 


12 


STATISTICS 


XDS 


BASE | 


| CLASS 


12 


STATISTICS 


XDS 


NUM. | 


j CLASS 


11 


STATISTICS 


XDS 


BANK j 


| CLASS 


11 


STATISTICS 


XDS 


BASE | 


| CLASS 


11 


STATISTICS 


XDS 


NUM. | 


| CLASS 


10 


STATISTICS 


XDS 


BANK | 


| CLASS 


10 


STATISTICS 


XDS 


BASE | 


| CLASS 


10 


STATISTICS 


XDS 


NUM. | 


i CLASS 


09 


STATISTICS 


XDS 


BANK | 


! CLASS 


09 STATISTICS XDS 


BASE j 


| CLASS 


09 


STATISTICS 


XDS 


NUM. | 










j COUNT j COUNT 


X £lJJA£3U£lJJ j 


i CLASS 2 EN.CNT. | CLASS 3 EN.CNT. j 


| CLASS U EN.CNT. | CLASS 5 EN.CNT. | 


| CLASS 6 EN.CNT. | CLASS 7 EN.CNT. | 


| CLASS 8 EN.CNT. | CLASS 9 EN.CNT. | 
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MEASINFOTAB (CONTINUED) 



I 55 1 CLASS 10 EN.CNT.I CLASS 11 EN.CNT. 1 
1 


I 56 | CLASS 12 EN.CNT.I CLASS 13 EN.CNT. | 


I 57 1 CLASS lU EN.CNT.I CLASS 15 EN.CNT. | 


1 60 | | 
J 


1 61 1 I 


for 62 | | 


clock 63 | | 


user 6k | | 


1 65 1 | 


I 66 | | 


1 67 I | 
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CHAPTER 18 MESSAGE FILES 



This chapter contains the data structures necessary to support message files, 
files. The first section details the message file's version of the 
familiar file system data structure; ie, the file label, file control 
block, access control block, etc.. 

The second section show the tables used by the basic ipc mechanism 
which is a set of internal, MPE procedures designed to support the 
"boundary conditions" of ipc files. For example, signalling a no wait 
reader that its record has arrived. See the section's introduction 
for a detailed description. 

{File Structure} 

{File label/FCB extent map} 

End of file block Start of file block 



: 


Disc 


addr of extent 





• 


: 


Disc 


addr of extent 


1 


: 


• 


Disc 


addr of extent 


2 


: 


: 


Disc 


addr of extent 


3 


• 


z 

• 








z 


• 


Disc 


addr of extent 


n-1 


: 


• 


Disc 


addr of extent 


n 


: 



The EOF and SOF are examples only, meant to show that 1) the start of 
file moves into the extent map as records are read and 2) that the 
file can wrap around and, hence, cause the SOF to be greater than the 
EOF. 

When a file becomes empty the SOF and EOF are reset to the first 
block of extent zero. 

Each extent is composed of a number of blocks. Extents all have the 
same numuer ox blocks . Extent zero also contains space for the file 
label and user labels in the exact same format as standard files. 
Starting with block zero, sufficient blocks are allocated to the file 
label/user labels to satisfy their space requirements. 

Extents outside of the SOF /EOF range may not exist. They are deleted 
at close time when there are no more writers accessing the file. 
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{Block Structure) 

*******»***#***##**#*#*##******#*# 

: First data record : 

: : Exact same format as standard 

: Second data record : variable length blocks. 

z z 

!•■•••••••«.. • 

: Last data record : 

«•••■•. • 

: Record delimeter (-1) : 

:....,. • ******##»*##*#*****#**#*#*##***### 

: Empty space (next record : 

: would not fit) : 

: : 

: Header delimiter (%77) : 

• ••••..« * 

: Last header record : 

2 Z 

: Second header record : 

»••♦••••..■... r * 

: First header record : 



Separating the data portion of the records from their header enables 
the standard file system access procedures to read the records with no 
knowledge that they are msg file records. 
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{Record Format} 



♦ 


Number of bytes in reeord 


• 


: 


First data word of record 


• 


z 




z 


• 


Last data word of record 


• 



Length word's value does not include itself. 
{Header Format} 



: C:LC: : Header Type: 

• • 

: Writer's ID : -1 



C (0:1) - Set on if this was the last record written before 
the system crashed. This bit is set on by the 
first open on the file after the crash. 

LC (1:1)- Valid only for close headers. Set to one if this is 
the last writer to close the file. 

Type (8: 8)- data 

1 open 

2 close 
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{Message Access Control Block} 

Notes: 

1. Words/fields that do not pertain to message files are left 
blank. 

2. This diagram shows the "combined" ACB as it appears to 
the message access procedures (the procedures in IPC). 
Thus it is a combination of the LACB and the PACB. 



: : Size of the ACB including buffers (words) : 

1 : : File number : 1 * 



2 : File name 



6 : Fopt ions 

7 : Aopt ions 



8 : Record size (bytes) 

9 : Block size (words) 



6 * 

7 * 



: 10 * 

: 11 * 



11 : Carriage control code (writers) 



13 



Ik : Error code 



19 : start of file block) 

20 : Logical record transfer count 

21 : 



16 



15 : Transmission log (units same as last read/write) : 17 * 



16 : Total number of unread records (includes opens 

17 : and closes) 



20 
21 



18 : Block number of the file's tail (relative to the : 22 



23 
2J+ 
25 
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22 : Physical block transfer count : 26 

95 . 'Of 

2U : Address of the head record's header : 30 

25 : Address of the next write header : 31 

26 : FCB control block vector : 32 
z z 

28 : Number readers : Number readers & writers : 3** 

29 z z 

30 : : Records per block : 36 

31 :Wrt buf indx: : # buf - 1 : 37 

32 : Address of the head record's data : U0 

33 : Size of the buffer (words) : kl 
z z 

38 : : Logical device number : 1+6 

39 :0:# rd buf : # wt buf :er :qw :m :c :d :s :f : U7 
U0 : Number of max sized free records : 50 
Ul : : 51 
1+2 : Number of free words in the current free record : 52 
U3 : Address of the next write record : 53 
UU : Number of nondata records in the file : 5** 

U5 : : 55 

U6 : # of read requests that have a claim on file : 56 






U8 : DST number of the physical ACB : 60 

1+9 : Address of the physical ACB : 6l 
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50 : DST number of the logical ACB : 62 

51 : Address of the logical ACB : 63 

52 : DST rel address of the stack access control blk : 6k 

53 : DST rel address of the DB area : 65 
5*+ : PACB vector table entry address : 66 

55 : PACB control block vector table address : 67 

56 : Target area's DST number : 70 

57 • Reserved for calling parameters : 71 

58 : : 72 

59 : : 73 

60 : Reserved for the stack marker from file system : 7^ 

61 : intrinsics : 75 
z z 

6k : User's soft interrupt plabel : 100* 

65 : Number of seconds to wait on boundary condition : 101* 

66 : 0:Ex:Nd:Vr:Bt:Cls :C : Carriage control : 102* 

67 : Reply Port (basic IPC port) : 103* 

68 : Writer ID : 10U* 

69 : Control block index for nowait writer record buf : 105* 

70 : DST relative addr of nowait writer record buffer : 106* 

71 : No wait I/O resultant error code : 107* 

72 : No wait I/O resultant transmission log : 110* 

73 : Write wait queue (basic IPC port) : 111 
Jk : Read wait queue (basic IPC port) : 112 

75 - Head record's length (bytes) : 113 

76 : Head record's record type (same values as header): llU 
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77 : 


: Head record's writer ID 


: 


78 


: Head record's header word value 


'- 


79 : 


: Max size record plus its overhead (words) 


'• 



115 
116 

117 

80 : ACB wait queue message - contains same info as : 120 

81 : the wait queue message in the Message Queue : 121 

82 : Entry J 122 

83 ! ................... ^^ 

Bk ': _ ^ 

85 : Waiter's reply port, if using ACB compltn area : 125 

86 : ACB completion message area - see Message Queue : 126 

87 : Entry for completion message format : 127 



88 : Waiting process's pin 

89 : Waiting process's file number 



130 
131 



90 : Waiting process's soft interrupt plabel 

91 : DST rel address of buffer one 



: 132 
: 133 



92 : DST rel address of buffer two 

93 : Etc. 



: 13U 
: 135 



* Value is private to a particular accessor. 
Word Field Description 



66 Accessor' s local flags. 

(0:1) 1 - have not yet issued an FREAD/FWRITE against 

the file. 
(1:1) ex 1 - extended wait mode. 
(2:1) nd 1 - do not destroy the next record read. 
(3:1) vr 1 - writer has not yet written his first record 

(ie. , he is a virgin). 
(U:l) bt - transmission log should be expressed in words. 

1 - " " bytes. 

(5:1) els Not currently used (reserved for group IPC 

standard) . 
(6:1) C No wait completion message is in LACB area. 
(8:8) car ctl carriage control character to be used for 
the writer's record (a value of one indi- 
cates no carriage control character). 
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Word Field Description 



39 File's global flags. 

(9:1) er 1 - extended read 

(10:1) qw 1 - one or more writers has been queued on the 

wait queue. 
(11:1) ml- wait msg is located in the ACB 

(12:1) c 1 - completion msg is located in the ACB 

(13:1) d 1 - the current write buffer has dirty bit set 

(lU:l) si- the start of file is block zero 

(15:1) f - the ACB buffers have not been filled 

{MMSTAT Definitions} 

Octal Event Type Parameter 1 Parameter 2 

Value 



72/0 


Read init 


# free rec 






72/1 


Read compl 


(0:8) 


error , 


(8:8) 


ID 


72/2 


Write init 


(0:8) 


# rec, 


(8:8) 


ID 


72/3 


Write compl 


(0:8) 


error , 


(8:8) 


ID 


72/U 


Control 


(0:8) 


error , 


(8:8) 


ID 


72/5 


EOF 


(0:8) 


error , 


(8:8) 


ID 


72/6 


Open 


(0:8) 


error, 


(8:8) 


ID 


72/7 


Close 


(8:8) 


#free, 


(8:8) 


ID 


72/10 


Initiation 











73/0 


Put record 


(0:8) 


error, 


(8:8) 


ID 


73/1 


Delete rec 


(0:8) 


error, 


(8:8) 


ID 


73/2 


Delete blk 


Start 


of fil« 


s block # 



Number of records 

Number of free records 

Number of free records 

(0:U) func, (U:12) parm 

Number of records 

Number of records 

Number of records 

(0:8) fix, (8:8) update 

(0:3) rec type, 

(3:13) number of records 

(0:3) rec type 

(3:13) number of records 



Notes : 

1. The aa/bb notation in the "octal value" column denotes 
type/subtype. Type is the actual MMSTAT event number. 
Subtype is (0:U) of parameter 0. 
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2. Several items can possibly exceed their fields, in that 
case the bits beyond the field are lost. These items are 
number of records, number of free records, start of file, 
and end of file. 

3. Parameter word zero has a common format for all the MMSTAT 
events . 

Field Description 

(0:U) Event's subtype. 

(U:2) File's state 

- empty 

1 - partially full 

2 - only a fraction of a free record is left 

3 - completely full 

(6:1) Nonzero indicates that there is one or more 
waiting readers. 

(7:1) Nonzero indicates that there is one or more 
waiting writers. 

(11:1) Nonzero indicates that the write has a carriage 
control character. 

(12: U) Flags local to the accessor. 

(12:1) - the accessor has done no FREADs/FWRITEs 

(13:1) - extended wait 

(lU:l) - nondestructive read 

(15:1) - writer has not written any records 
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{File System Basic IPC Definitions) 



The objective of this set of uncallable procedures is to provide a 
simple ipc mechanism to support the ipc file access procedures. It 
enables one process to send short, control messages to another process. 

{General behavior} 

{FCPORTOPEN procedure} 

The heart of this mechanism is the port. A process desiring to 
receive messages would first open (create) a port. This process is 
termed the "port manager." When the port is created, a port number is 
returned to the opener. Since the port number value cannot be known 
in advance, potential senders need some method of obtaining the port 
number from the port manager. 

Both the ports and the messages are contained in a single disc 
resident data segment. There can be a total of over thiry-five 
hundred open ports and outstanding messages Thus neither ports nor 
message blocks are scarce resources. 

{FCPORTSEND procedure} 

This procedure sends a to 5 word message to a port. Optionally a 
timeout value may be specified which will limit the duration the 
message will remain attached to the port. Expiration of the timeout 
causes the message to be deleted from the target port's queue and 
placed on the sender's reply port (specified by the sender in the 
FCPORTSEND procedure call) . 

{FCPORTRECEIVE} 

Reads and deletes the head message from a port. The sender's return 
port number is also given to the receiver, enabling him to send a 
reply message. 

{FCPORTCLOSE} 

Demolishes the port. 



{IPC File's Use of the IPC Mechanism} 

All open message files have two ports open for the file (read wait 
queue and write wait queue), plus one port per accessor (reply port), 
Their use is described in the following. 
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{Reader and writer wait queues} 

When an empty message file is accessed by more than one reader 
(share), then there must be a way of having the readers' FREADs 
satisfied in the same order that they were issued. That is, there 
must be queue of waiting readers. The ipc access procedures 
accomplish this by dedicating a basic ipc port as a "read wait 
queue." Whenever a reader's request is stalled because the file 
is empty, a message is sent to the read wait queue. Subsequent 
FREADs by other processes will queue up behind the first reader in 
a FIFO manner. An FWRITE will take the first entry from the wait 
queue and send a "read may be done" message to the reader's reply 
port. 

In a like manner multiple writers will queue on the write wait 
queue when the file is full. 

{Completion notification for nowait 1/0} 

The I0WAIT intrinsic waits for a message to be sent to the reply 
port (s) of the specified user files. 

{Timeouts } 

When an accessor encounters a boundary condition (ex, a reader 
accesses an empty file), it may specify that the condition must be 
satisfied in x seconds (FCONTROL U) . To this end the ipc access 
procedures merely issue the FCPORTSEND to the wait queue with the 
user's timeout value specified. The timeout will tear the message 
from the wait queue and place it on the accessor' s reply port. 
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{Port Data Structures} 
{Port data segment) 



System DB extension :Port DST #: 
+ %100 



Port data segment 



Global area 



: Remainder is : 


: composed of : 


: "block size" : 


: chunks . : 



The chunks are a combination of free entries, ports, message queue 
entries, and timer list entries. 



{Port with two outstanding messages} 



Port 



: MQE 1 



MQE 2 
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{Port number} 
1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 16 
sPort index : Port data segment relative addr/8 ; 

Port index Index into the port DST number array 



{Port DST Number Array} 
Located in System DB Extension Area. 



6k : Port data segment number : 6k 

65 : Reserved for a second port segment : 65 
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{Port Data Segment Global Area} 



: Data segment number of this port data segment : 



: 1 



1 : Block size in words 

2 : Total number of blocks : 2 

3 : Maximum number of blocks : 3 
k : Current number of free blocks : k 

5 : Number of open ports : 5 

6 : Head of free list : 6 

7 : Tail of free list .......... ^ 

10 : Head of impeded process list : 8 

11 : Tail of impeded process list ; 9 

12 : Head of timeout thread (TQE address) : 10 

13 : TRLX of timeout ............ ^ 

lU : Value returned by TIMER intrinsic when : 12 

15 : Timeout was initiated. : 13 

16 : Head of port list (in units of port numbers). : ll+ 

17 : Not used. . 3c 
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{Port} 
1 2 3 h 5 6 7 8 9 10 11 12 13 lU 15 

: Head MQE address : 

1 : Tail MQE address : 1 

2 :E : W : Next port number in port list thread: 2 

3 : Soft int subtype : Pin of port's owner : 3 
U : Soft interrupt parameter one : ** 

5 : Number of MQEs in the port's queue : 5 

6 : Number of sends to this port : 6 

7 : Soft interrupt plabel '• 7 
:0 :1 :2 :3 :^ :5 :6 :7 :8 :9 :10:ll:12:13:lU:15: 

E Enable wake up bit 

- Do not awaken the process 

1 - Awaken the process 

W type Action to be taken on an enabled port when a message is 
received. 

- Awaken the process on a message wait bit. 

1 - Generate user software interrupt 

2 - Generate system software interrupt 
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{Message Queue Entry (MQE)} 
l 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 16 

: Next MQE entry; if last, (port addr) LOR 7 : 

1 : Port number of return port : 1 

2 :Time List Entry (TLE),0=no timeout, -l=timed out: 2 

3 : Parameter zero : 3 
k : Parameter one : U 

5 : Parameter two : 5 

6 : Parameter three : 6 

7 : Parameter four : 7 
:0 :1 :2 :3 :U :5 :6 :7 :8 :9 :10:ll:12:13:lU:15: 

Timer entry definitions - - no timeout 

1 - timeout expired 

2 - TLE address for a pending timeout 

File System Message Files 



Wait Message 

parm# 

- WRITER ID 

1 - LOCAL FLAGS (differ with each accessor) 

(0:1) - accessor just opened file 

(1:1) - will wait on boundary condition if no symbiotic process 

(3:1) - writer has not written a record 

(k:l) - transmission log in bytes 

(8:1) - carriage control code 

2 - DST# of data buffer 

3 - Address of data buffer (DST relative) 
U - Length of data buffer in bytes 

Completion Message 

- Resultant error code 

1 - Resultant transmission log in bytes 
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{Timer List Entry (TLE)} 
1 2 3 H 5 6 7 8 9 10 11 12 13 lU 15 

: Next TLE (sorted in incr time val) , if last: 

1 : Preceding TLE entry (0 if first entry) : 1 

2 : Number of milliseconds the timeout value : 2 

3 : of this TLE is beyond the previous TLE. : 3 
U : Address of the affected MQE : ** 

5 : Address of the MQE's port : 5 

6 : Value of TIMER when this timeout expires : 5 

7 : (Milliseconds) : 7 
:0 :1 :2 :3 :^ :5 :6 :J :8 :9 :10:ll:12:13:lU:15: 

{MMSTAT Definitions) 



Octal 


Event Type 


Parameter 


Parameter 1 


Parameter 2 


Value 












62 


Open 


Port 


number 


Port DST num 


Flags paramet 


63 


Receive 
completion 


Port 


number 


MQE address 
15:1 Waitspc 


Return port 


6U 


Send 


Port 


number 


MQE address 
15:1 Q type 


Return port 


65 


Change 


Port 


number 


= enable 


Head MQE 




status 






1 = disable 


address 


66 


Abort 


Port 


number 


Parameter 
zero 


Return port 


61 


Close 


Port 


number 


Port DST 


# open 
ports left 


70 


Expand 


Port 


DST num 


# expand blks 


Total # 
blocks 


71 


Timeout 
expired 


Port 


num 


MQE address 


Return port 
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CHAPTER 19 MPE Memory Resident Message Facility 



I . Overview 

The memory resident message facility of MPE IV addresses the need 
for an efficient, simple, and -uniform method for system code to 
send short status-type messages to processes. 

Each process is created with a message harbor which supports a 
set of message ports which are private to that process. There 
is a maximum of four ports per harbor in the initial 
implementation. This limit can be easily extended when new ports 
are required. 

Any system code, even code running on the ICS, can send a message 
to any port of any process. The destination process' PIN must be 
known, and a priori conventions on portnumber and message 
formats must be established. The caller of SENDMSG may optionally 
specify that the destination process be awakened from a message 
wait. 

The caller of SENDMSG specifies whether the message is to be 
buffered in the primary message table or the secondary message 
table. When the secondary table is specified, if the pool of 
secondary message entries is exhausted, the calling process is 
queued for a message table entry and blocked until one becomes 
available. Use of the primary message table is reserved for code 
running on the ICS or during critical sections (Pdisabled or 
Disabled intervals) in which it is not possible to release 
control of the processor to queue for a free message table entry. 
If the primary table is specified and no free entries are 
available, the SENDMSG crashes the system. 

Messages can be of any length up to the configured maximum. 
Message length is specified in the call to SENDMSG and 
RECEIVEMSG. In the initial implementation, messages are limited 
to U words in length. This maximum can be easily increased if the 
need arises. 

n— — ii-;-„ □rrDTCP ATTIC •* rvrnnact! maw a+ n-nv time rfp+.prmine 

whether a specified port is non-empty or obtain the portnumber 
of his most urgent non-empty port (lowest numerical port number 
=mpst urgent port). 

By calling RECEIVEMSG, a process may receive the message at the 
head of his specified message port. This receive is optionally 
non- destructive . 

A process can wait on a message wait, or on a combination of 
message wait and other wait types. 
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II. Message Intrinsics 

A. Procedure SENDMSG(Destpin, Destport,Msglength, Flags) ; 
Value Destpin,Destport,Msglength, Flags; 
Integer Destpin,Destport,Msglength; 
Option Privileged, Uncallable; 
Logical Flags; 

Destpin, Destport, and Msglength had better be within 
range and reasonable (process and port exist), since 
SENDMSG checks and will crash if the parameters are bad. 

The caller of SENDMSG stacks the message contents before 
calling the procedure. SENDMSG expects the first msg 
word to be at Q-7-Msglength, and the last msg word at 
Q-8. The message contents at Q-8 to Q-7-Msglength are 
deleted from top of stack by the exit from SENDMSG to 
the caller. 

Flags. (1:1)=1 ==> Wake-up destination process from a 
message wait 
.(0:1)=1 ==> place message in secondary message 
table 
Return CC=CCG if process was already awake else CC=CCE. 



Logical Procedure PORTSTATUS(Portnumber) ; 

Value Portnumber; 

Integer Portnumber; 

Option Privileged, Uncallable; 

When supplied a valid port number, PORTSTATUS returns a 
true value if the port is non-empty and a false value if 
the port is empty. 

When passed a -1 as portnumber parameter, PORTSTATUS 
returns the portnumber of the process' most urgent 
non-empty port (the smaller the number, the more urgent 
the port ) . 

If all ports are empty, PORTSTATUS returns CC=CCE. If 
at least one port is non-empty, PORTSTATUS returns 
CC=CCG. 
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C. Procedure RECEIVEMSG (Portnum,Msglength, Flags ) ; 
Value Portnum,Msglength, Flags; 
Integer Portnum,Msglength; 
Option Privileged, Uncallable; 
Logical Flags ; 

Portnum and Msglength had better be within range or else 
its Suddendeath time. 

The caller of RECEIVEMSG does an ADD S Msglength to make 
space for the message contents. RECEIVEMSG stores the 
message contents into Q-8,Q-9, . . . ,Q-7-Msglength. 
Q-7-Msglength contains the first word of the message. 

Flags. (0:1)=1 ==> do not release message from head of 

port's message queue (non-destructive 
read) 

Return CC=CCG if port was empty, else CC:=CCE. 
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III. Supporting Data Structures 

A. Message Harbor Table [DST #57 ($71)] 



The message facility is presently used only by the 
Dispatcher and should not be used by any process. The Message 
Harbor Table is created during system generation. It is a 
resident structure, though needn't reside in bank 0. Its 
base is located through the DST entry which describes it. 



* LINK TO FIRST MSG PORT * MESSAGE HARBOR 
* * 

* LINK TO FIRST MSG PORT 1 * TABLE ENTRY 
# * 

* LINK TO FIRST MSG PORT 2 * FORMAT 
# # 

* LINK TO FIRST MSG PORT 3 * 
# * 

* NON-EMPTY PORT MASK * 

* * 



FIRST MSG QUEUE LINK .(0:1) =1 ==> NEXT MESSAGE IN SECONDARY 

MESSAGE TABLE 
.(1:15) = INDEX OF NEXT ENTRY IN 
APPROPRIATE TABLE 



B. Message Tables 



Prim Msg Tab DST = #58 (%72) 
Sec Msg Tab DST = #17 (%21) 

There are two types of tables which are used to buffer 
sent messages, the primary and secondary message tables. 
The tables are identical in format, but independently 
configurable with respect to size. Both tables are resident 
structures, though they needn't be located in bank 0. 
The bases of the message tables are located by looking up 
their addresses in the DST entry describing them. 



* # OF CONFIGURED ENTRIES * 

# # 

* # ENTRY SIZE (5) * MESSAGE TABLE 
# * 

* # ENTRIES AVAILABLE * ENTRY ZERO 
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* # 

* INDEX OF FIRST FREE ENTRY * FORMAT 
* * 

* PIN OF FIRST IMPEDED PROCESS * 

* # 

* NEXT MSG IN QUEUE LINK * MESSAGE TABLE 
* # 

* MSG WORD 1 * ASSIGNED ENTRY 

#____, , _# 

* MSG WORD 2 * FORMAT 
# * 

* MSG WORD 3 * 
* * 

* MSG WORD U * 

* * 

* 7.100000 * 

* INDEX NEXT FREE ENTRY * 

# * FREE ENTRY 

* Don't Care * 

* * FORMAT 

* Don't Care * 
* * 

* Don't Care * 

NEXT MSG IN QUEUE LINK .(0:1) =1 ==> NEXT MESSAGE IN SECONDARY 

MESSAGE TABLE 
.(1:15) = INDEX OF NEXT ENTRY IN 
APPROPRIATE TABLE 



C. Message Port Assignments 



Message Port 

Message Port 1 
Message Port 2 
Message Port 3 



Junk Port (to be used when no message 

interference can occur.) 
Reserved (for message facility) 
Reserved (for message facility) 
Image Port / deferred IOMESSPROC task 
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CHAPTER 20 



MMSTATS EVENT CATALOG 



MMSTATS CATALOG INDEX 



EVENT NAME 


EVENT NO. 






EVENT NAME 


EVENT NO. 




DEC. ' 


% 








DEC. 


% 


ALCSTBLK 


20 


02U 


(-) 


* 


FREAD 


62 


076 (-) 


ALLOCMEM 


12 


01U 




* 


FREADDIR 


6k 


100 (-) 


BINREAD 


233 


351 


(-) 


« 


FREADLABEL 


76 


11U (-) 


BREAK 


237 


355 


(-) 


# 


FREADSEEK 


68 


10U (-) 


CABORTIO 


lU2 


216 




* 


FRENAME 


80 


120 (-) 


CCLOSE 


1U6 


222 




# 


FSETMODE 


72 


110 (-) 


CCLOSETRACEFILE 


15U 


232 




* 


FSPACE 


69 


105 (-) 


CCONTROL 


152 


230 




* 


FUNLOCK 


79 


117 (-) 


CGARBAGE 


7 


007 




* 


FUPDATE 


66 


102 (-) 


CONFIG-INFO 


221 


335 


(-) 


* 


FWRITE 


63 


077 (-) 


CONFIG-INFO 


222 


336 


(-) 


« 


FWRITEDIR 


65 


101 (-) 


CONFIG-INFO 


223 


337 


(-) 


* 


FWRITELABEL 


77 


115 (-) 


COPEN 


litO 


2lU 




* 


GIPINTERRUPT 


192 


300 


COPENTRACEFILE 


153 


231 




* 


IOBUFTRAP 


125 


175 


CPOLLIST 


155 


233 




« 


I/O COMPLETION 


111 


157 (-) 


CREAD 


1U7 


223 




« 


IOWAIT 


67 


103 (-) 


CREAD1 


1U7 


2U0 




* 


MAKEOC 


1 


001 


CSDRIVER 


150 


226 




« 


MONINIT 


228 


3UU (-) 


CSIOWAIT 


lUU 


220 




# 


MONOFF 


229 


3^5 (-) 


CWRITE 


1U9 


225 




# 


PROCESS COMPLETE 


211 


323 (-) 


DC1DC2ACK 


231 


3U7 


(-) 


* 


QONSEG 





000 


DEALLOCM 


13 


015 




* 


QUIESCE 


Uo 


050 


DEALCSTBLK 


21 


025 


(-) 


# 


RELRESOURCES 


23 


027 (-) 


DISKBUGCATCHER 


200 


310 




« 


SEGIOINIT 


5 


005 










* 


SIODM-ENTRY 


19U 


302 


DISKBUGCATCHER 


201 


311 




* 


SIODM-EXIT 


195 


303 


DISKERROR 


100 


ikk 


(-) 


* 


SIODONE 


6 


006 


DISKERROR 


101 


1U5 


(-) 


* 


SPECCHAR 


236 


35U (-) 


DISKINTRPT 


191 


277 




* 


SPECIALRQ 


2 


002 


SOFT 'DEATH 


120 


170 




* 


SPECREAD 


238 


356 (-) 










# 


START I/O 


193 


301 


DISK TRAFFIC 


98 


1U2 


(-) 


* 


SWAPIN 


8 


010 


FCHECK 


71* 


112 


(-) 


* 


SYSPINS 


22U 


3U0 (-) 


"Et/fT /*\C«T? 


EM 


■1 01 


i _ "1 


* 


CVODTHC 


225 


1 ill i - \ 


r i>uwo£i 


UJ. 


j-cl 


\~ 1 




■j--— \ 1 


FCONTROL 


71 


107 


(-) 


# 


SYSPINS 


226 


3U2 (-) 


FETCHSEG 


u 


00U 




# 


SYSPINS 


227 


3^3 (-) 


FGETINFO 


75 


113 


(-) 


* 


TERMLOGOFF 


235 


353 (-) 


FLOCK 


78 


116 


(-) 


* 


TERMLOGON 


23 1 * 


352 (-) 


FOPEN/(DA) 


60 


07U 


(-) 


* 


TERMREAD 


230 


3U6 (-) 


FOPEN/(DA) 


61 


075 


(-) 


* 


TERMWRITE 


232 


350 (-) 


FPOINT 


70 


106 


(-) 


* 
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« * 

* « 

* MMSTAT EVENT GROUP * 

* « 

* MEMORY MANAGER * 



EVENT 

EVENT NAME: QONSEG 

DESCRIPTION: ABSENCE TRAP ON CODE/DATA SEGMENT 

CALLING MODULE: KERNELC 

CALLING PROCEDURE (S): QUEUEONSEGMENT 

PARAMETER DESCRIPTION 



PI = SEGIDENTIFIER.(0:2) = SEG TYPE FIELD 

=0 => SEG IS A DATA SEGMENT, 

. <2:lU) - DST ENTRY NUMBER 
=1 => SEG IS AN SL SEGMENT, 

. (2:ll4) = SL ENTRY NUMBER 
= 2,3 => SEG IS PART OF A PROGRAM, 
.(1:7) = PROGRAM INDEX 

INTO CSTBLK 
.(8:8) = LOGICAL SEGMENT 
NUMBER (0-255) 
P2 ■ PCBOl(CPCB) - SLL POINTER 
P3 = STATUS (IN STACK MARKER) OF CALLING (TRAPPING) SEGMENT 
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EVENT 1 



EVENT NAME: MAKEOC 

DESCRIPTION: MAKE SEGMENT AN OVERLAY CANDIDATE - RELEASE SEGMENT 
TO THE POOL OF AVAILABLE SPACE 

CALLING MODULE: KERNELC 
CALLING PROCEDURE: MAKEOC 

PARAMETER DESCRIPTION 



PI = SEGIDENTIFIER.(0:2) = SEG TYPE FIELD 

=0 => SEG IS A DATA SEGMENT 

. (2:lU) = DST ENTRY NUMBER 
=1 => SEG IS AN SL SEGMENT 

. (2:lU) = SL ENTRY NUMBER 
= 2,3 => SEG IS PART OF A PROGRAM, 
.(1:7) = PROGRAM INDEX 
.(8:8) = LOGICAL SEGMENT NUMBER 
(0-255) 
P2 = (UNUSED) 
P3 = (UNUSED) 
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EVENT 2 



EVENT NAME: SPECIALRO 

DESCRIPTION: REQUEST OF SEGMENT EXPANSION/CONTRACTION, UNLOCK, 
UNFREEZE, IOUNFREEZE, LOCK, IOFREEZE, FREEZE 

CALLING MODULE: KERNELC, KERNELD, ININ 

CALLING PROCEDURES: UNLOCKSEG' , IOFREEZE', FETCHSEGMENT- (KERNELC) 

DLSIZE, ZSIZE, GETPXSEG, ALTDSEGSIZE, 
ALTPXFILESIZE -(KERNELD) 

STACKOVERFLOW - ( ININ ) 

PARAMETER DESCRIPTION 



PI = SEGIDENTIFIER.(0:2) = SEG TYPE FIELD 

=0 => SEG IS A DATA SEGMENT, 

.(2:lU) = DST ENTRY NUMBER 
=1 => SEG IS AN SL SEGMENT, 

. (2:lU) = SL ENTRY NUMBER 
=2,3 => SEG IS PART OF A PROGRAM, 
.(1:7) = PROGRAM INDEX 

INTO CSTBLK 
.(8:8) = LOGICAL SEGMENT 
NUMBER (0-255) 



P2 ■ 


■ .(0:1) 


=1 => 1 

i 


REQUEST IS THROUGH FETCHSEGMENT (TYPES 
0,1,2) 




.(12:U) 


TYPE ( 


OF REQUEST 






= 0=> 


IOFREEZE 






= 1=> 


FREEZE 






= 2=> 


LOCK 






= 3=> 


IOUNFREEZE 






= k=> 


UNFREEZE 






- 5=> 


UNLOCK 






= 6=> 


DLSIZE EXPANSION 






= 7=> 


DLSIZE CONTRACTION 






= 8=> 


PXFIXED EXPANSION 






= 9 => 


PXFILE EXPANSION 






= 10=> 


PXFILE CONTRACTION 






= 11=> 


XDS EXPANSION 






= 12=> 


XDS CONTRACTION 






= 13=> 


ZSIZE EXPANSION 






= 1U*» 


ZSIZE CONTRACTION 






= 15=> 


STACKOVERFLOW 


P3 > 


= FOR TYPES (P2.(12:U)) 






■ 0,2,: 


3,5 => P3.(8:8) = LOCK OR IOFREEZE COUNT 






= 1,U = 


=> P3.(0:8) = FREEZE COUNT 






= 6-15 


=> REQUESTED SIZE OF AREA IN WORDS 
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EVENT U 



EVENT NAME: FETCHSEG 

DESCRIPTION: SEGMENT REQUEST (FOR I/O SYSTEM OR PROCESS) 

CALLING MODULE: KERNELC 
CALLING PROCEDURE: FETCHSEGMENT 

PARAMETER DESCRIPTION 



PI = SEGIDENTIFIER.(0:2) = SEG TYPE FIELD 

=0 => SEG IS A DATA SEGMENT, 

. (2:lU) = DST ENTRY NUMBER 
=1 => SEG IS AN SL SEGMENT, 

. (2:lU) = SL ENTRY NUMBER 
= 2,3=> SEG IS PART OF A PROGRAM, 
.(1:7) = PROGRAM INDEX 

INTO CSTBLK 
.(8:8) = LOGICAL SEGMENT 
NUMBER (0-255) 
P2 = REQUESTORID 

.(0:1) =1 => I/O SYSTEM REQUEST 

.(8:8) = LDEV # 
,(0:1) = => PROCESS REQUEST 

.(8:8) = PIN # OF REQUESTING PROCESS 
.(1:1) =1 => IOFREEZE REQUEST 
.(2:1) = 1 => BLOCKED LOCK REQUEST 
.(3:1) =1 => LOCK REQUEST 
. (U:l) =1 => FREEZE REQUEST 
P3= .(13:3)= => SEGMENT ALREADY PRESENT 

=1 => SEGMENT IS RECOVERABLE OVERLAY CANDIDATE 
=2 => SEGMENT ALREADY ON ITS WAY IN FOR SOMEONE 
=3 -> SEGMENT NOT PRESENT -- MUST FETCH 
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EVENT 5 



EVENT NAME: SEGIOINIT 

DESCRIPTION: MEMORY MANAGEMENT READ/WRITE OF SEGMENT FROM/TO 
DISC QUEUED 

CALLING MODULE: KERNELC 

CALLING PROCEDURES: PROCESSINITMSG , STARTSEGWRITE 

PARAMETER DESCRIPTION 



PI = SEGIDENTIFIER. (0:2) = SEG TYPE FIELD 

=0 => SEG IS A DATA SEGMENT, 

. (2:lU) = DST ENTRY NUMBER 
=1 => SEG IS AN SL SEGMENT, 

.(2:llt) = SL ENTRY NUMBER 
= 2,3 ■> SEG IS PART OF A PROGRAM, 
.(1:7) = PROGRAM INDEX 

INTO CSTBLK 
.(8:8) = LOGICAL SEGMENT 
NUMBER (0-255) 
P2 ■ DISCREQUEST INDEX - INDEX INTO THE DISC REQUEST TABLE 

(SYSDB RELATIVE) 
P3 = .(0:1) = 1 => WRITE START 
■ => READ START 
.(2:15) = LDEV # 
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EVENT 6 



EVENT NAME: SIODONE 

DESCRIPTION: MEMORY MANAGEMENT SEGMENT READ/WRITE FROM/TO DISC 
COMPLETE 

CALLING MODULE: EERNELC 

CALLING PROCEDURES: SEGREADCOMPLETOR , SEGWRITECOMPLETOR 

PARAMETER DESCRIPTION 



PI = SEGIDENTIFIER.(0:2) = SEG TYPE FIELD 

= => SEG IS A DATA SEGMENT, 

. (2:lU) = DST ENTRY NUMBER 
= 1 => SEG IS AN SL SEGMENT, 

. (2:lU) = SL ENTRY NUMBER 
= 2,3=> SEG IS PART OF A PROGRAM, 
.(1:7) = PROGRAM INDEX 

INTO CSTBLK 
.(8:8) = LOGICAL SEGMENT 
NUMBER (0-255) 
P2 = DISCREQUEST INDEX - INDEX INTO THE DISC REQUEST TABLE 

(SYSDB RELATIVE) 
P3 = .(0.1) = 1 => WRITE COMPLETE 
=0 => READ COMPLETE 
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EVENT 7 (%7) 

EVENT NAME: CGARBAGE 

EVENT DESCRIPTION: GARBAGE COLLECTION HAS JUST TAKEN PLACE 

CALLING MODULE: KERNELC 

CALLING PROCEDURE: COLLECTGARBAGE 

PARAMETER DESCRIPTION 

PI = BANK OF SOURCE JUST MOVED FROM 
P2 = ADDR OF SOURCE JUST MOVED FROM 
P3 = MOVEPAGECNT, NUMBER OF PAGES JUST MOVED FROM 
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EVENT 8 (5410) 



EVENT NAME: SWAPIN 
DESCRIPTION: SWAP IN A PROCESS 

CALLING MODULE: KERNELC 
CALLING PROCEDURE: SWAPIN 

PARAMETER DESCRIPTION 



PI = PIN OF PROCESS BEING SWAPPED IN 
P2 = .(0:1) = => BEING SWAP 
= 1 => END SWAP 
.(1:1) = => NORMAL (PARTIAL SWAP OK) 

= 1 => SWAP REQUIRED 
. (12:U)= => PROCESS SWAPIN COMPLETE 

2 => NO ROOM, HARD REQ MAY SUCCEED 

3 => NO ROOM, HARD REQ FAILED 

k => SWAPIN STOPPED - MORE URGENT ACTIVITY 
8 => NO LOCK SPACE 
P3 = HARDREQUEST = TRUE => HARD REQUEST ON SWAPIN 

FALSE=> NORMAL 
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« * 

* « 

* MMSTAT EVENT GROUP 1 • 

* MEMORY MANAGER « 
» * 



EVENT 12 (%lk) 



EVENT NAME: ALLOCMEM 

DESCRIPTION: FOUND A HOLE FOR A SEGMENT REPLACEMENT REQUEST 

CALLING MODULE: KERNELC 

CALLING PROCEDURE: RESERVEREGION 

PARAMETER DESCRIPTION 

PI = REQUESTED SIZE IN PAGES 
P2 = BANK OF SELECTED REGION 
P3 = ADDRESS OF SELECTED REGION 



EVENT 13 (%15) 



EVENT NAME: DEALLOCM 

DESCRIPTION: RELEASE REGION OF MEMORY TO AVAILABLE STATUS 

CALLING MODULE: KERNELC 

CALLING PROCEDURE: RELEASEREGION 

PARAMETER DESCRIPTION 



PI = SIZE RELEASED IN PAGES 

P2 = BANK OF RELEASED REGION BASE 

P3 = ADDRESS OF RELEASED REGION BASE 
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* « 

* * 

* MMSTAT EVENT GROUP 2 * 

MEMORY MANAGER 

* # 

* » 



EVENT -20 (-%2k) 



EVENT NAME: ALCSTBLK 

DESCRIPTION: REQUEST TO RESERVE A BLOCK OF ENTRIES IN THE CSTX 

CALLING MODULE: KERNELD 
CALLING PROCEDURE: ALCSTBLOCK 

PARAMETER DESCRIPTION 



P1=EIX CST BLOCK INDEX ASSIGNED 
P2=CSTX DST RELATIVE INDEX OF WORD 

OF THE FIRST RESERVED CSTX ENTRY 
P3=N NUMBER OF CSTX ENTRIES RESERVED 



EVENT -21 (%25) 

EVENT NAME: DEALCSTBLK 

DESCRIPTION: INDICATES THAT A CST EXTENSION BLOCK HAS BEEN 
DEALLOCATED 

CALLING MODULE: KERNELD 
CALLING PROCEDURE: DEALCSTBLOCK 

PARAMETERS PARAMETER DESCRIPTION 

P1=EIX CST BLOCK INDEX ASSIGNED 

TO THE BLOCK OF CST ENTRIES 

P2=CSTX DST RELATIVE INDEX OF WORD 
OF THE FIRST CST ENTRY TO BE 
RELEASED 

P3=MCNT =(#ALLOCATED CSTX ENTRIES- 

#ENTRIES BEING RELEASED) *U 
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EVENT -23 (-%27) 

EVENT NAME:RELRESOURCES 

DESCRIPTION: RESOURCES (VDS.MAIN MEMORY, ST ENTRY) RESERVED FOR THE 
FOR THE SEGMENT HAVE BEEN RELEASED 

CALLING MODULE: KERNELD 

CALLING PROCEDURE: RELDATASEG 

PARAMETERS PARAMETER DESCRIPTION 

P1=NEW DB DST NUMBER 
P2=DELTA P AT EXCHANGEDB CALL 

P3=STATUS AT EXCHANGEDB CALL 
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« « 

* MMMSTAT EVENT GROUP 3 * 

* (NOT CURRENTLY ASSIGNED) * 

* « 
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* # 

* MMSTAT EVENT GROUP It * 

* SCHEDULING * 



EVENT UO (%50) 



EVENT NAME: QUIESCE 

DESCRIPTION: PROCESS SWITCH - STATE OF PROCESS SAVED 

CALLING MODULE: KERNELC 
CALLING PROCEDURE: DSP 



PARAMETER DESCRIPTION 



PI = PCBOO(CPCB) 




•(0:1) = 


1 


=> SAR 


.(2:1) = 


1 


=> CRIT 


•(3:1) = 


1 


=> HSIR 


.(U:l) = 


1 


=> PIOVR 


.(5:1) = 


1 


=> HSPRI 


•(6:1) = 


1 


=> IPEXP 


.(7:1) = 


1 


=> PC 


•(8:1) = 


1 


=> MP 


.(9:1) = 


1 


=> LW 


.(10:1)= 


1 


=> SW 


.(11:1)= 


1 


=> TRW 


.(12:1) = 


1 


=> USEQD 


.(13:1)= 


1 


=> HIPRI 


.(lU:l)- 


1 


=> ALLOW 



(15:1)= 1 



SCHEDULING ATTENTION REQUIRED 
PROCESS IS CRITICAL 
PROCESS HAS SIR 
PENDING PI, PROCESS CRITICAL 
HOLD SIR PRIORITY 
INCORE PROTECT EXPIRED 
PREMPT CAPABILITY 
MUST PREMPT 
LONG WAIT 
SHORT WAIT 
TERMINAL READ WAIT 
USED A QUANTUM SINCE TRANSACTION 

BEGAN 
HOLD IMPEDED PRIORITY 
ALLOW SOFT INTERRUPTS EVEN THOUGH IN 
SYSTEM CODE 
RITBK - PROCESS IN RIT BREAK 
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P2 = 



P3 = 



PCBOU(CPCB) 








•(0:1) = 


1 


=> M 


- MOURNING WAIT 


.(1:1) = 


1 


=> RG 


- GLOBAL RIN WAIT 


.(2:1) = 


1 


=> RL 


- LOCAL RIN WAIT 


.(3:1) = 


1 


=> MA 


- MAIL WAIT 


.(U:l) = 


1 


=> BIO 


- BLOCKED 10 WAIT 


.(5:1) = 


1 


= > 10 


- 10 WAIT 


.(6:1) = 


1 


=> UCP 


- UCOP WAIT, RIT WAIT 


.(7:1) = 


1 


=> JNK 


- JUNK WAIT 


.(8:1) = 


1 


=> TIM 


- TIMER WAIT 


•(9:1) = 


1 


=> INT 


- INTERRUPT WAIT 


.(10:1)= 


1 


=> SON 


- SON WAIT 


.(11:1)= 


1 


=> FA 


- FATHER WAIT 


.(12:1)= 


1 


=> IMP 


- PROCESS WAITING TO UNIMPEDED 


.(13:1)= 


1 


=> SIR 


- PROCESS WAITING FOR SIR 


.(1U:1)= 


1 


=> TIM 


- PROCESS WAITING FOR TIME OUT 


.(15:1)= 


1 


=> MEM 


- PROCESS WAITING FOR MEMORY 


PCB13(CPCB) 








.(0:1) = 


1 


=> DISPQ 


- PROCESS ON DISPATCHING QUEUE 


.(1:1) = 


1 


=> L SCHEDULING CLASS 


.(2:1) = 


1 


=> C SCHEDULING CLASS 


.(3:1) = 


1 


=> D SCHEDULING CLASS 


•(U:l) = 


1 


=>' E SCHEDULING CLASS 


.(5:1) = 


1 


=> INTKK- 


• PROCESS IS INTERACTIVE 


•(6:1) = 


1 


=> CORER- 


■ PROCESS IS CORE -RESIDENT 


.(8:8) = 


PROCESS' SCHEDULING PRIORITY 
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» * 

* MMSTAT EVENT GROUP 6 * 

* FILESYS * 

* THESE EVENTS ARE FOR DEVELOPMENT USE ONLY * 



EVENT -60017 1 *) 

EVENT NAME: FOPEN 
DESCRIPTION: OLD FILE OPEN 

CALLING MODULE: FILEACC 

CALLING PROCEDURE: FOPENDA 

PARAMETERS PARAMETER DESCRIPTION 



Pl= FILE # (0:2)=2 -> NON-SPOOLER ACCESS 
(0:2). NE. 2 -> 

P2= AOPTIONS SEE INTRINSICS MANUAL 



P3= FILE LABEL FOPTIONS SEE INTRINSICS MANUAL 

EVENT -6l(%75) 

EVENT NAME: FOPEN' 

DESCRIPTION: OLD DISC FILE OPEN (CONTINUATION OF EVENT -60) 

CALLING MODULE: FILEACC 

CALLING PROCEDURE: FOPENDA 

PARAMETERS PARAMETER DESCRIPTION 

Pl= RECORD SIZE 

P2= FILE LABEL BLOCK SIZE 

P3= # OF BUFFERS 
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EVENT -61 (#75) 

EVENT NAME: FOPEN* 

DESCRIPTION: OLD FILE OPEN (CONTINUATION OF EVENTS -60 & -6l) 

CALLING MODULE: FILEACC 

CALLING PROCEDURE: FOPENDA 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE LABEL FILE LIMIT MSW 

P2= FILE LABEL FILE LIMIT LSW 

P3= FILE LABEL # OF EXTENTS 
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EVENT -60 (%7k) 

EVENT NAME: FOPEN 
DESCRIPTION: NEW DISC FILE OPEN 

CALLING MODULE: FILEACC 

CALLING PROCEDURE: FOPEN 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # (0:2)=2 -> NON-SPOOLER ACCESS 

(0:2). NE. 2 -> 
P2= AOPTIONS SEE INTRINSICS MANUAL 

P3= FOPTIONS SEE INTRINICS MANUAL 

EVENT -6l(%75) 

EVENT NAME: FOPEN' 

DESCRIPTION: NEW DISC FILE OPEN (CONTINUATION OF EVENT -60) 

CALLING MODULE: FILEACC 

CALLING PROCEDURE: FOPEN 

PARAMETERS PARAMETER DESCRIPTION 

Pl= RECORD SIZE 

P2= BLOCK SIZE 

P3= # OF BUFFERS 
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EVENT -6l(%75) 

EVENT NAME: FOPEN' 

DESCRIPTION: NEW DISC FILE OPEN (CONTINUATION OF EVENT -60 & -6l) 

CALLING MODULE: FILEACC 

CALLING PROCEDURE: FOPEN 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FCB FILE LIMIT 

P2= FCB MAX # EXTENTS 

P3= (0:8)= INITIAL ALLOCATION EXTENTS 
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EVENT -62(%76) 

EVENT NAME: FREAD 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FREAD 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # (0:1) BUFFER HIT FLAG 



P2= ACBTLOG 



TRANSFER COUNT 



P3= NOT USED 

EVENT -63(%77) 

EVENT NAME: FWRITE 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FWRITE 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # (0:1) BUFFER HIT FLAG 



P2= TCOUNT 



SEE INTRINSIC MANUAL 



P3= NOT USED 
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EVENT -6U(%100) 

EVENT NAME: FREADDIR 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FREADDIR 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # (0:1) BUFFER HIT FLAG 

P2= ACBTLOG TRANSFER COUNT 

P3= NOT USED 

EVENT -6MJ&100) 

EVENT NAME: FREADDIR' 

DESCRIPTION: CONTINUATION OF EVENT -6U FREADDIR 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FREADDIR 

PARAMETERS PARAMETER DESCRIPTION 

Pl= REC # MSW 

P2= REC # LSW 

P3= NOT USED 
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EVENT -65(%101) 

EVENT NAME: FWRITEDIR 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING MODULE: FWRITEDIR 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILENUM (0:1) BUFFER HIT FLAG 

P2= TCOUNT SEE INTRINSIC MANUAL 

P3= NOT USED 

EVENT -65(%101) 

EVENT NAME: FWRITEDIR' 

DESCRIPTION: CONTINUATION OF EVENT -65 FWRITEDIR 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FWRITEDIR 

PARAMETERS PARAMETER DESCRIPTION 

Pl= REC # MSW 

P2= REC # LSW 

P3= NOT USED 
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EVENT -66(51102) 

EVENT NAME: FUPDATE 
DESCRIPTIONS 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FUPDATE 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # (0:1) BUFFER HIT FLAG 



P2= TCOUNT 



SEE INTRINSIC MANUAL 



P3= NOT USED 

EVENT -67(%103) 

EVENT NAME: IOWAIT 

DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: IOWAIT 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # (0:1) BUFFER HIT FLAG 



P2= ACBTLOG 



TRANSFER COUNT 



P3= NOT USED 
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EVENT -6&(%10h) 

EVENT NAME: FREADSEEK 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FREADSEEK 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE f (0:1) BUFFER HIT FLAG 

P2= REC # MSW 

P3= REC # LSW 

EVENT -69(%105) 

EVENT NAME: FSPACE 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FSPACE 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # 

P2= DISPLACEMENT SEE INTRINSIC MANUAL 

P3= NOT USED 
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a************************************************************** 

» * 

* MMSTAT EVENT GROUP 7 * 

* FILESYS * 

* THESE EVENTS ARE FOR DEVELOPMENT USE ONLY * 



EVENT -70(%106) 

EVENT NAME: FPOINT 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FPOINT 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # 

P2= REC # MSW 

P3= LSW LSW 

EVENT -71(%107) 

EVENT NAME: FCONTROL 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FCONTROL 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # 

P2= CODE SEE INTRINSIC MANUAL 

P3= NOT USED 
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EVENT -72(51110) 

EVENT NAME: FSETMODE 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FSETMODE 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # 

P2= MODEFLAGS SEE INTRINSIC MANUAL 

P3= 

EVENT -7M%112) 

EVENT NAME: FCHECK 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FCHECK 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # 

P2= ERRORCODE SEE INTRINSIC MANUAL 

P3= 
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EVENT -75(%113) 

EVENT NAME: FGETINFO 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FGETINFO 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # 

P2= FOPTIONS SEE INTRINSIC MANUAL 

P3= AOPTIONS SEE INTRINSIC MANUAL 

EVENT -76(f.llU) 

EVENT NAME: FREADLABEL 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # 

P2= TCOUNT SEE INTRINSIC MANUAL 

P3= 
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EVENT -77(51115) 

EVENT NAME: FWRITELABEL 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FWRITELABEL 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # 



P2= TCOUNT 



SEE INTRINSIC MANUAL 



P3= 

EVENT -78(%ll6) 

EVENT NAME: FLOCK 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FLOCK 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # 

P2= LOCKCOND SEE INTRINSIC MANUAL 



P3= COND CODE 



SEE INTRINSSIC MANUAL 
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EVENT -79(%117) 

EVENT NAME: FUNLOCK 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FUNLOCK 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # 

P2= 

P3= 
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* MMSTAT EVENT GROUP 8 * 
» « 

* THESE EVENTS ARE FOR DEVELOPMENT USE ONLY * 

* « 



EVENT -80(%120) 

EVENT NAME: FRENAME 
DESCRIPTION: 

CALLING MODULE: FILEACC 

CALLING PROCEDURE: FRENAME 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # 

P2= 



P3= 

EVENT -8l(%121) 

EVENT NAME: FCLOSE 
DESCRIPTION: 

CALLING MODULE: FILEACC 

CALLING PROCEDURE: FCLOSE 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE f 



P2= DISP 



SEE INTRINSIC MANUAL 



P3= SECCODE 



SEE INTRINSIC CODE 
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WW************************************************************* 

* 

# 



# 



* MMSTAT EVENT GROUP 9 



* 



« DISC I/O TRANSFER REQUESTS 



* 
« 



* THESE EVENTS ARE FOR DEVELOPMENT USE ONLY * 

a************************************************************** 

EVENT -98(?tlU2) 

EVENT NAME: DISK TRAFFIC 

DESCRIPTION: DISC I/O REQUEST HAS BEEN QUEUED 

CALLING MODULE: HARDRES 

CALLING PROCEDURE: ATTACHIO 

PARAMETERS PARAMETER DESCRIPTION 

P1=CNT DATA TRANSFER COUNT: WORDS IF >0; 
BYTES IF <0 

P2=FLAGS.(G:U) 

P3=FNCT =0 ==>READ 
=1 ==>WRITE 
=2 ==>OPEN FILE 
=3 ==>CLOSE FILE 
=U ==>CLOSE DEVICE 
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* * 

* « 

* MMSTAT EVENT GROUP 10 * 

DISC ERRORS 
» * 

» * 

EVENT 100(JbW0 

EVENT NAME: DISK ERROR 
DESCRIPTION: RECORD DISC ERROR 

CALLING MODULE: IOFDISC1 

CALLING PROCEDURE: FHDDVR 

PARAMETERS PARAMETER DESCRIPTION 

P1=DIPT(DSTAT) HARDWARE STATUS 
P2=S0 QMISC 

P3=IOQP(QLDEV).QLDEVN LOR STOCOUNT&LSL(8) ) 
=LDEV/SIO PROGRAM COUNTER 

EVENT 101(%lU5) 

EVENT NAME: DISK ERROR 
DESCRIPTION: RECORD DISC ERROR 

CALLING MODULE: IOMDISCO 

CALLING PROCEDURE: MHDDVR 

PARAMETERS PARAMETER DESCRIPTION 



P1=DIPT(DSTAT) HARDWARE STATUS 
P2=S0 QMISC 

P3=IOQP(QLDEV).QLDEVN LOR STOCOUNT&LSL(8) ) 
=LDEV/SIO PROGRAM COUNTER 
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It************************************************************** 

* » 

* * 

* MMSTAT EVENT GROUP 11 * 

SIO 

* * 

* * 
ft************************************************************** 

EVENT -110(Jil56) 

EVENT NAME: START I/O 

DESCRIPTION: DRIVER INITIATOR FOR SIO DEVICE HAS BEEN CALLED 

CALLING MODULE: HARDRES 

CALLING PROCEDURE: SIODM 

PARAMETERS PARAMETER DESCRIPTION 

Pl=IOQPL(QSTAT) LOR IOQPL(QLDEV) .LDEVN 

=(0:8) PCB ENTRY # OF PROCESS MAKING REQUEST 
(8:8) LOGICAL DEVICE NUMBER OF DEVICE FOR I/O 
P2=IOQP(QWBCT)=WORD COUNT IF>0;BYTE COUNT IF<0 
P3=(0:2) = FUNCTION CODE SPECIFIED BY DRIVER 

= => READ 
= 1 => WRITE 
= 2 => CONTROL 

=(6: 10)= DSTN OF TARGET DATA SEG 

EVENT -111 (#157) 

EVENT NAME: I/O COMPLETION 
DESCRIPTION: SIO COMPLETION 

CALLING MODULE: HARDRES 

CALLING PROCEDURE: SIODM 

PARAMETERS PARAMETER DESCRIPTION 

Pl=IOQP(QLDEV).LDEVN=LOGICAL DEVICE NUMBER OF 

DISC INVOLVED IN TRANSFER 
P2=I0QP(QPAR1) (DEFINED BY DRIVER) 
P3=IOQP(QPAR2) (DEFINED BY DRIVER) 
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* » 

* * 

* MMSTAT EVENT GROUP 12 * 

SOFT DEATH 

* * 

* « 

EVENT 120(Jll70) 

EVENT NAME: SOFT' DEATH 
DESCRIPTION: BUG CATCHER 

CALLING MODULE: HARDRES 

CALLING PROCEDURE: SOFT 'DEATH 

PARAMETERS PARAMETER DESCRIPTION 

PI SOFT'DEATH I.D. NUMBER 
P2 CALLERS STATUS REGISTER 
P3 CALLERS DELTA P 



EVENT 125 (%175) 



EVENT NAME: IOBUFTRP 

EVENT DESCRIPTION: IOSYSTEM BUFFER TRAP 

CALLING MODULE: HARDRES 
CALLING PROCEDURE: SIODM 

PARAMETER DESCRIPTION 

PI = IOQP 

P2 = IOQP (QDSTN) .DSTN = DST NUMBER OF BUFFER 

P3 = 
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ft*************************************************************** 
« * 

* * 

* MMSTAT EVENT GROUP 13 * 
« * 

* MPE I/O DISC ATTACHIO INFO * 

EVENT -130 (-%202) 

EVENT NAME: ATTACHIO disc 

DESCRIPTION: Additional ATTACHIO disc info to supplement group 9. 

CALLING MODULE: Unknown 

CALLING PROCEDURE: Unknown 

PARAMETERS PARAMETER DESCRIPTION 

PI LDEV# of disc 

P2 P-offset of calling code segment 

P3 STATUS register of caller 



EVENT -131 (-51203) 

EVENT NAME: ATTACHIO disc 
DESCRIPTION: 

CALLING MODULE: Unknown 

CALLING PROCEDURE: Unknown 

PARAMETERS PARAMETER DESCRIPTION 

PI High-order file extent base sector 
address (if instrumented). 

P2 Low-order file extent base sector 
address (if instrumented). 

P3 Extent size in sectors (if 
instrumented) . 
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EVENT -132 (-%20U) 

EVENT NAME: ATTACHIO disc 
DESCRIPTION: 

CALLING MODULE: Unknown 

CALLING PROCEDURE: Unknown 

PARAMETERS PARAMETER DESCRIPTION 

PI PI or high-order sector address 
of requested transfer. 

P2 P2 or low-order sector address 
of requested transfer. 

P3 FLAGS word of ATTACHIO call, where 
. (0:1*) = Unknown I/O requestor 

1 general file sys, no instrumentation 

2 spooler, no instrumentation 

3 directory I/O 

U-7 unassigned as of Q-MIT 
8 GENMESSAGE, where extent base is 
is message-set base and extent size 
is message-set sectors. 

BUF, FQUIESCEIO. 
NOBUF, sequential 
NOBUF, direct access 
BUF, sequential 
BUF, direct access 
KSAM 
IMAGE 



9 File 


sys, 


10 File 


sys, 


11 File 


sys, 


12 File 


sys, 


13 File 


sys, 


Ik File 


sys, 


15 File 


sys, 
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WW************************************************************* 

# * 

* * 

* MMSTAT EVENT GROUP lU * 



# 



* 



* CS/3000 * 

www************************************************************ 

EVENT 1U0 (%2llt) 
EVENT NAME: COPEN 
DESCRIPTION: 

CALLING MODULE: COMSYS2 

CALLING PROCEDURE: COPEN 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUMBER 

P2 PMAP1 

P3 PMAP2 
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EVEKT lU2 (5&216) 

EVENT NAME: CABORTIO 
DESCRIPTION: 

CALLING MODULE: COMSYS1 

CALLING PROCEDURE: CABORTIO 

PARAMETERS PARAMETER DESCRIPTION 

PI LOGICAL DEVICE 

P2 IOQINDEX 

P3 
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EVENT lUU (%220) 

EVENT NAME: CSIOWAIT 
DESCRIPTION: 

CALLING MODULE: COMSYS1 

CALLING PROCEDURE; CSIOWAIT 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUMBER 

P2 TRANSMISSION LOG 

P3 



EVENT 1U6 (%222) 

EVENT NAME: CCLOSE 
DESCRIPTION: 

CALLING MODULE: COMSYS3 

CALLING PROCEDURE: CCLOSE 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUMBER 

P2 LINE NUMBER 

P3 
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EVENT ll*7 (91223) 



EVENT NAME: CREAD 
DESCRIPTION: 



CALLING MODULE: COMSYSU 

CALLING PROCEDURE: CREAD 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUMBER 

P2 INCOUNT 

P3 STATION 



EVENT 1U9 (%225) 



EVENT NAME: CWRITE 
DESCRIPTION: 



CALLING MODULE: COMSYSl* 

CALLING PROCEDURE: CWRITE 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUMBER 

P2 OUTCOUNT 
P3 INCOUNT 
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* 
* 

* 
* 

* MMSTAT EVENT GROUP 15 

* 

* CS/3000 



EVENT 150 (%226) 



EVENT NAME: CSDRIVER 
DESCRIPTION; 



CALLING MODULE: BSCLCM 

CALLING PROCEDURE: CSDRIVER 

PARAMETERS PARAMETER DESCRIPTION 
PI TIMER LSW 



P2 CURRENTSTATE WHERE THE DRIVER IS IN THE 

STATE TRANSITION TABLE 

P3 CURRENTEVENT (0:8) = CURRENT EVENT 

(8:8) = LOGICAL DEVICE 
WHAT CAUSED THE DRIVER TO BECOME 
ACTIVE 



EVENT 152 (%230) 
EVENT NAME: §CONTROL 
DESCRIPTION 

CALLING MOBULJ: g$MSYS5 

CALLING PROCEDURE: CCgNTROL 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUMBER 

P 2 CONTROL CODE 

P3 PAJEAMETER 
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EVENT 153 (51231) 



EVENT NAME: COPENTRACEFILE 
DESCRIPTION: 



CALLING MODULE: 

CALLING PROCEDURE: COPENTRACEFILE 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUMBER 

P2 CTRACEINFO 

P3 

EVENT 15U (%232) 

EVENT NAME: CCLOSETRACEJILE 
DESCRIPTION: 

CALLING MODULE; 

CALLING PROCEDURE! CCLOSETRACEFILE 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUMBER 

P2 
P3 
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EVENT 155 (%233) 

EVENT NAME: CPOLLIST 
DESCRIPTION: 

CALLING MODULE: 

CALLING PROCEDURE: CPOLLIST 

PARAMETERS PARAMETER DESCRIPTION 

PI LOGICAL DEVICE 

P2 CS ERROR CODE 
P3 PMAP 
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* * 
« « 

* MMSTAT EVENT GROUP 16 * 



cs/3000 



• * 



EVENT 160(%2U0) 



EVENT NAME: CREAD 
DESCRIPTION: 

CALLING MODULE: DSMON 

CALLING PROCEDURE: 



PARAMETERS 



PARAMETER DESCRIPTION 



Pl= TIME STAMP 

P2= (0:h) NOT USED 
(k:l) BLOCK 
(5:2) STATE 
(7:3) NEXT 
(10:1) :=0 
:=1 



INITIALIZATION EVENT 
COMPLETION EVENT 



(11:5) SUB EVENT NUMBER 

P3= DEPENDS ON THE SUB EVENT NUMBER AND 

IF ITS A INTIALIZATION OR COMPLETION EVENT. 
MSG: (0:U) STRMTYPX 
(1»:6) MSG CLS 
(10:16) STRMTYP 



SUB 


SUB EVENT 


INIT 


EVENT NO. 


NAME 


PARM 





CREAD 





1 


CWRITE 


X MSG 


2 


IOWAIT 





3 


CCHECK 





k 


DSATTN 





5 


DSWC 


X MSG 


6 


CHNGEWAIT 


PARM 


7 


MONREQ 


REQ 


10 


CABORT 





11 


CRESET 





12 


CSDATA 


R MSG 


13 


CSREREAD 





COMP 
PARM 

LEN 
LEN 
LEN 
ERRCOD 


R MSG 




T/F 
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* * 

* * 

« uumiAm ctrcMin nnATin in * 



MMSTAT EVENT GROUP 19 
DISC CONTROLLER INTERRUPT 



# #4H»ft«#*#**»»*****#*****«*#*##«##*****#*#********************** 



EVENT 19K%277) 

EVENT NAME: DISKINTRPT 

DESCRIPTION: A 7905/7920 CONTROLLER IS PROCESSING AN ATTENTION INTERRUPT 
(ONLINE/OFFLINE) 
CALLING MODULE: HARDRES 

CALLING PROCEDURE: SIODM 

PARAMETERS PARAMETER DESCRIPTION 

Pl= gDITP (US)--ie.WHO GOT THE INTERRUPT 



P2= gDITP 



(THEM) — ie. WHO RAN THE POLL PROGRAM 



P3= DITP 



"OUR" DIT FLAGS WORD 



THERE SHOULD BE AT LEAST AN #300 AND AN %303 FOR EACH SIO PRGM. 
A SINGLE ISOLATED (IN TIME) REQUEST WILL GENERATE AT LEAST A 
%303, %300, %303. IF THE QUEUE OF IOQE'S ON A DIT NEVER EMPTIES, 
THERE WOULD BE ONE %300 AND ONE %303 PER SIO PRGM. 
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EVENT 192(31300) 



EVENT NAME: GIPINTERUPT 

DESCRIPTION: INTERRUPT JUST PROCESSED 



CALLING MODULE: HARDRES 

CALLING PROCEDURE: GIP 
PARAMETERS 
Pl= (0:7) 



(8:9) 



PARAMETER DESCRIPTION 

LDEV note a) its easy to read in octal 
b) ldevs > 127 will 
be recorded mod 128 
ADDRESS CONTAINED IN DRT WORD RE- 
LATIVE TO SIO PROGRAM AREA (ie where 
did it stop?) 
ABS(DRTN*l+)-(ILTP(ISIOP)+SYSDB)) 



P2= DEVICE STATUS (the TIO GIP just did) 



P3= LSW of a call to TIMER 
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EVENT 193(7.301) 

EVENT NAME: STARTIO 

DESCRIPTION: Issuing SIOP machine instruction. 

CALLING MODULE: HARDRES 

CALLING PROCEDURE: START 'HPIB, STARTIO 

PARAMETERS PARAMETER DESCRIPTION 

Pl= DRT number. 

P2= Absolute address of SIO program to start. 

P3= LSW of TIMER 
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EVENT 19U(%302) 

EVENT NAME: SIODM-ENTRY 
DESCRIPTION: Entering SIODM 

CALLING MODULE: HARDRES 

CALLING PROCEDURE: SIODM 

PARAMETERS PARAMETER DESCRIPTION 

Pl= (0:7) LDEV — SAME AS 192(*300) 

(8:9) a IOQ table relative index 

to convert this into the number that 
is formated by DPAN2, multiply this num- 
ber by %13 and add %10,that will be the 
number in the left column of returned 
IOQ'S— add the table base to get the 
DPAN number for "in-use" enries. 



P2= DIT WORD (DIT FLAGS) — note that P2.(12:U) 
contains the state we are "leaving" 

P3= (0:U) THE CONTENTS OF DIT0.(l2;lt) 
ie, the state we entered in 

(U:12) LSW OF TIMER -- note the difference 

between P3 of %300 and 
P3 of %303, these 12 bits 
will hold "U.l seconds which 
is enough for 30229 con- 
trollers purpose and DS 
timeouts (some types). 
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EVENT 195 (5&303) 

EVENT NAME: SIODM-EXIT 

DESCRIPTION: Leaving SIODH main loop. 

CALLING MODULE: HARDRES 

CALLING PROCEDURE: SIODM 

PARAMETERS PARAMETER DESCRIPTION 

Pl= (0:7) LDEV — SAME AS 192(%300) 

(8:9) a IOQ table relative index 

to convert this into the number that 
is formated by DPAN2, multiply this num- 
ber by %13 and add %10,that will be the 
number in the left column of returned 
lOQ'S-- add the table base to get the 
DPAN number for "in-use" enries. 



P2= DIT WORD (DIT FLAGS) — note that P2.(12:U) 
contains the state we are "leaving" 

P3= (0:k) THE CONTENTS OF DITO. (12:10 
ie, the state we entered in 

(It: 12) LSW OF TIMER -- note the difference 

between P3 of %300 and 
P3 of %303, these 12 bits 
will hold "k.l seconds which 
is enough for 30229 con- 
trollers purpose and DS 
timeouts (some types). 
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» « 

« « 

* MMSTAT EVENT GROUP 20 * 

PRIVATE VOLUMES 

* « 

* THESE EVENTS ARE FOR DEVELOPMENT USE ONLY * 

* * 



EVENT 200(%310) 

EVENT NAME: DISKBUGCATCHER 
DESCRIPTION: 

CALLING MODULE: PVSYS 

CALLING PROCEDURE: MVTABLE 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FUNCT 

P2= MVTABX 

P3= DELTAP 



EVENT 201(%3H) 

EVENT NAME: DISKBUGCATCHER 
DESCRIPTION: 

CALLING MODULE: PVSYS 

CALLING PROCEDURE: USERTABLE 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FUNCT 

P2= MVTABX 

P3= DELTAP 
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* • 

MMSTAT EVENT GROUP 21 * 

* PROCESS CREATIONS AND TERMINATIONS * 

* LOGICAL PROCESS TABLE * 

EVENT -211(%323) 

EVENT NAME: PROCESS COMPLETION 
DESCRIPTION: PROCESS HAS TERMINATED 

CALLING MODULE: MORGUE 

CALLING PROCEDURE: TERMINATE 

PARAMETERS PARAMETER DESCRIPTION 

P1=0 
P2=0 
P3=0 



20-51 



• * 

* « 

* MMSTAT EVENT GROUP 22 * 

MONITOR CONFIGURATION INFORMATION 

» * 

# TIME STAMP OF EVENT TRACE * 

ENABLE AND DISABLE 



EVENT 221(%335) 

EVENT NAME: CONFIGURATION INFORMATION 
DESCRIPTION: EVENT GROUP MASK 

CALLING MODULE: CRIO 

CALLING PROCEDURE: CONSMON 

PARAMETERS PARAMETER DESCRIPTION 

Pl= MEASMSKO 

P2= MEASMSK1 

P3= 
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EVENT 222(7.336) 

EVENT NAME: CONFIGURATION INFORMATION 
DESCRIPTION: MPE VERSION FIX UPDATE 

CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS PARAMETER DESCRIPTION 

Pl= VERSION 

P2= FIXL 

P3= UPDATEL 



EVENT -223 (-%337) 

EVENT NAME: CONFIGURATION INFORMATION 

DESCRIPTION: SYSTEM TABLE LOCATIONS AND AVAILABLE LINKED MEMORY 
INFORMATION 
CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS PARAMETER DESCRIPTION 

PI =F (541032 ) =@CST ( ) -gDST ( ) 

=DISPLACEMENT TO CODE 

P2=F (%1033 ) =@CST ( LAST ) -€DST ( ) 

=DISPLACEMENT TO SHARABLE 

P3=LOGICAL(TOTAL&DLSK(U))=LINKED MEMORY SIZE 
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EVENT -22*4 -(%3U0) 

EVENT NAME: SYSPINS 

DESCRIPTION: LOGICAL PROCESS TABLE 

CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS PARAMETER DESCRIPTION 

Pl=ABSOLUTE(5tllUl)=PROGEN'S PCBENTRY NUMBER 
P2=ABSOLUTE(j4lll»2)=MAM'S PCB ENTRY NUMBER 
P3=ABSOLUTE(5lllil3)=UCOP , S PCB ENTRY NUMBER 

EVENT -225 (-%3Ul) 

EVENT NAME: SYSPINS ( CNTD . ) 
DESCRIPTION: LOGICAL PROCESS TABLE 

CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS PARAMETER DESCRIPTION 

Pl=ABSOLUTE(%lll*lt)=PFAIL'S PCB ENTRY NUMBER 
P2=ABSOLUTE(%llU5)=DEVREC'S PCB ENTRY # 
P3=ABSOLUTE(%lllt6)=PRMSG'S PCB ENTRY # 

EVENT -226 (-%3 1 +2) 

EVENT NAME: SYSPINS (CNTD. ) 
DESCRIPTION: LOGICAL PROCESS TABLE 

CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS PARAMETER DESCRIPTION 



Pl=ABSOLUTE(%lllt7)=STMSG'S PCB ENTRY # 
P2=ABS0LUTE (%1150 )=LOG'S PCB ENTRY # 
P3=ABSOLUTE (341151 )=LOAD'S PCB ENTRY # 
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EVENT -227 (-&3U3) 

EVENT NAME: SYSPINS(CNTD. ) 
DESCRIPTION: LOGICAL PROCESS TABLE 

CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS PARAMETER DESCRIPTION 

Pl=ABSOLUTE(frL152)=IOMESSPROC'S PCB ENTRY # 
P2=ABSOLUTE(%1153)=SYSIOPROC'S PCB ENTRY # 
P3=ABSOLUTE(5J115U)=MEMLOGP , S PCB ENTRY # 



EVENT -228 (%3U1+) 



EVENT NAME: TIMESTAMP 
DESCRIPTION: TIMESTAMP 

CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS 



PARAMETER DESCRIPTION 



P1=CALENDER (0:7)=YEAR OF CENTURY 
(7:9)=DAY OF YEAR 

P2=CLOCK(WORD1).(0:7)=HOUR OF DAY 

(8:8)=MINUTE OF HOUR 

P3=CLOCK(WORD2). (0:7)=SECONDS INTO MINUTE 
. (8:8)=TENTHS OF SECONDS 



EVENT -229 (-&3U5) 



EVENT NAME: MONOFF 
DESCRIPTION: END EVENT TRACING 

CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS 

P1=0 
P2=0 
P3=0 



PARAMETER DESCRIPTION 
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* # 

* MMSTAT EVENT GROUP 23 * 
» * 

* TERMINAL I/O * 



EVENT 230 (%3U6) 



EVENT NAME: TERMREAD 

DESCRIPTION: TERMINAL READ COMPLETION 

CALLING MODULE: HARDRES 
CALLING PROCEDURE: TIP 

PARAMETERS PARAMETER DESCRIPTION 

PI = LDEV 

P2 = READ DURATION 

P3 = BYTES READ 

EVENT 231 (%3*t7) 



EVENT NAME: DC1DC2ACK 

DESCRIPTION: DC1/DC2 HAS BEEN SATISFIED 

CALLING MODULE: HARDRES 
CALLING PROCEDURE: TIP 

PARAMETERS PARAMETER DESCRIPTION 

PI = LDEV 

P2 = DURATION (BETWEEN START AND DC2) 

P3 = BYTES READ (EXCLUDING DC2) 
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EVENT 232 (%350) 



EVENT NAME: TERMWRITE 
DESCRIPTION: WRITE COMPLETION 

CALLING MODULE: IOTERMO 
CALLING PROCEDURE: TERMIOM 

PARAMETERS PARAMETER DESCRIPTION 

PI = LDEV 

P2 = 

P3 = BYTE COUNT OF TRANSFER 



EVENT 233 (#351 ) 



EVENT NAME: BINREAD 

DESCRIPTION: BINARY READ COMPLETED 

CALLING MODULE: HARDRES 
CALLING PROCEDURE: TIP 

PARAMETERS PARAMETER DESCRIPTION 

PI « LDEV 

P2 = DURATION 

P3 = BYTES READ 
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EVENT 23U (%352) 



EVENT NAME: TERMLOGON 

DESCRIPTION: TERMINAL JUST LOGGING ON 

CALLING MODULE: IOTERMO 
CALLING PROCEDURE: TERMIOM 

PARAMETERS PARAMETER DESCRIPTION 
PI = LDEV 
P2 = 
P3 ■ 



EVENT 235 (%353) 



EVENT NAME: TERMLOGOFF 

DESCRIPTION: TERMINAL JUST LOGGED OFF 

CALLING MODULE: IOTERMO 
CALLING PROCEDURE: TERMIOM 

PARAMETERS PARAMETER DESCRIPTION 
PI = LDEV 
P2 = 
P3 ■ 
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EVENT 236 (f.35 1 *) 



EVENT NAME: SPECCHAR 

DESCRIPTION: PROCESSED SPECIAL CHARACTER 

CALLING MODULE: HARDRES 
CALLING PROCEDURE: TIP 

PARAMETERS PARAMETER DESCRIPTION 

PI = LDEV 

P2 = SPECIAL CHARACTGER PROCESSED 

P3 = 



EVENT 237 (%355) 



EVENT NAME: BREAK 
DESCRIPTION: PROCESSED BREAK 

CALLING MODULE: HARDRESS 
CALLING PROCEDURE: TIP 

PARAMETERS PARAMETER DESCRIPTION 
PI = LDEV 
P2 = DSTATE 
P3 = 
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EVENT 238 (%356) 



EVENT NAME: SPECREAD 

DESCRIPTION: SPECIAL READ TERMINATION CHARACTER DETECTED 

CALLING MODULE: HARDRES 
CALLING PROCEDURE: TIP 

PARAMETERS PARAMETER DESCRIPTION 

PI = LDEV 

P2 = DURATION 

P3 = BCNT 
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CHAPTER 21 



DATA COMMUNICATIONS TABLES 



LOWER LEVEL DS/3000 TABLES 



DATA COMMUNICATIONS IOQ ENTRY 



0| 

I 

II 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
._,__! __|__|-_|-|-|-|-|-|--|--|--|--|--|- 



51 
I 

61 
I 

71 



9! 



101 



I 



(SEE BELOW) 
NEXT I OQP 



2 | UNIT # | QLDEVN 
j 

3| IOQ STATN/LAST STATN REF 
| 

U|S | BUFFER DST 



BUFFER1 ADDR 

j FUNCTION 



COUNT/TLOG 
BUFFER2 ADDR/CONTROL CODE 



TC0UNT2 /PARAMETER 



USER PCBN 



| I/O QS | I/O GS 



S=STACKFLAG 



QS=QUALIFIED STATUS 
GS=GENERAL STATUS 



BITO ABORT 
BIT3 SYS BUFFER 
BITU 10 WAKE 
BIT5 BLOCKED 
BIT6 COMPLETED 
BIT7 DATA FROZEN 
BIT8 MAM ERROR 
BIT 10 SFAIL 
BIT11 PFAIL 
BIT14 TIMER 
BIT15 MSG ERROR 



GS 0=PENDING 

GS 1=SUCCESSFUL 

GS 2=END OF TRANSMISSION 

RECEIVED 
GS 3=UNUSUAL CONDITION 



Word 



.ABORT 
.SYSBUF 
.IOWAKE 
.BLOCKED 

.COMPLETE 
.DATAFRZN 



Abort this I/O request 
Data is in system buffers 
Wake caller upon completion 
Blocked I/O, do blocked AWAKE 
when I/O is complete 
Request has been completed 
The DST has been frozen 
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.MAMERRORD - MAM failed to freeze the DST 
.SFAIL - The I/O program failed to start 

due to no SIO OK 
•PFAIL - The Abort bit was set because 

of a power failure 
.TIMED - An I/O timeout request has completed 
.MSGDONE - A message reply has been completed 
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DS Line Control Block (DSLCB) 



1 2 3 U 5 6 7 8 9 10 11 12 13 lb 15 
| o 



l 2 3 U 5 6 7 8 9 10 11 12 13 lb 15 

|AB| R| L| I $STDLIST or ERRCODE | 

ENTRY FORMAT 

AB - Set when a line error occurs (ABORT bit) 
R - Request is in progress 
L - Line opened 
(8:8) - If AB set then ERRCODE, else if session 
then $STDLIST LDEV, else a zero. 

NOTES 

Contained in DSMON'S DL-DB area Line Control Block. 
One entry is created for each DSOPEN main process, 
otherwise the entry is set to zero. DSLCB table 
size (in words) is the number of PCB's in system+1. 
Indexed by PIN. 
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DSGLOBAL DATA SEGMENT 




1 
2 



DSGLOBINFO TABLE BASE OFFSET (SEG. 


REL) j 


DSXREF TABLE BASE OFFSET (SEG. 


REL) | 


DSDEVICE TABLE BASE OFFSET (SEG. 


REL) ! 


DS GLOBAL INFORMATION TABLE | 


DSXREF TABLE | 


DSDEVICE TABLE | 



(-1) 

( o) 



(-1) 

( o) 



(-1) 

( o) 



NOTES 

The DSGLOBAL data segment is referenced by a DST 
number stored at SYSDB+%320. All tables in this 
segment have a standard format which require the 
negative oneth and zeroth entries to contain the 
number of entries and an entry size respectively. 
Segment relative table bases point to entry zero. 
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DSGLOBINFO 
1 2 3 h 5 6 7 8 9 10 11 12 13 1U 15 

NUMBER OF REAL ENTRIES i (-1) 



ENTRY SIZE 
NUMBER OF CONFIGURED DS LINES IN SYSTEM 
//!RS!RE|RM|//i DS CAPABILITY MASK (WORD) 
DS INFO DATA SEGMENT NUMBER 



NOTES 

This table is used to hold information which is 
global in respect to the DS/3000 software within 
the system. 

CURRENT NUMBER OF ENTRIES: 3 
CURRENT ENTRY SIZE (WORDS): 1 

RS - Remote can use sequence numbers. 

RE - Remote can use exclusive mode w/o excl. protocol. 

RM - Remote supports multi-packet algorithm. 



! ( o) 


i ( i) 


I ( 2) 


i ( 3) 
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DSXREF 



1 2 3 *+ 5 6 7 8 9 10 11 12 13 lU 15 

NUMBER OF REAL ENTRIES | (-1) 

ENTRY SIZE | ( 0) 
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DSXREF TABLE NOTES (DS1) 

The DSXREF table will contain an entry for each 
process in the system. For pseudo terminals for 
which a session exists, the entry corresponding 
to the main PIN contains one of the preceding 
single word entry formats. If this is a master 
request, the Request Control Word is contained 
as the DSXREF entry. If the current request is 
initiated by a slave, the RCW is contained in 
word 9 of the IODSTRMO (pseudo terminal) DIT. 

Request state: 

= Command out 

1 = PTOP out 

2 = PTOP in break mode; reply pending 

3 = PTOP in break mode. 



SLAVE ENTRY FORMAT (DS1) 

1 2 3 k 5 6 7 8 9 10 11 12 13 Ik 15 

1| P| | SLAVE PSEUDOTERM LDEV | 
- -| 

o ! 

i 

n i 



MASTER ENTRY FORMAT (DS1) 
1 2 3 it 5 6 7 8 9 10 11 12 13 1U 15 
| P| |PB|REQ. STATE | CURR MASTER REQ. LDEV 







RCW 



P - Inhibit next breakmode request across line. 
PB - Current BREAK request issued by PCLOSE. 
RCW - Request control word. 
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DSXREF table notes (X.25) 



The DSXREF table will contain an entry for each process in the 
system. The current entry size is 3 words, which contains 
Request Control Word (RCW) , Line Control Word (LCW) and Saved 
IOQ Word (SIOQW) . 

The format for master ( or slave master ) entries is: 

1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 

RCW j| 1 | | PB I REQ. STATE I Curr master req LDEV. 



LCW 



SIOQW 



„|„|==|==|«|«|«|==l==l«l==l==l==l»l--l' 
| R| Num. son proc. | Curr master req UC. 

==l==l==l==l==l==l==l==l==l==l==l==l==l==l==l ; 

==l==l==l==l==l==l==l==l==l==l==l==l==l==l==h 

save IOQ index ( PTOP break ) 



If the current request is initiated by a slave process (slave 
(acting as a master), and the process number is equal to the 
mainpin then the RCW, LCW and SIOQW are contained in IODSTRMX 
DIT. 

IODDSTRMX DIT 



RCW 



LCW 



SIOQW 



Jill TMSTR 



17 TLCW 



20 TSIOQW 
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For pseudo terminals for which a session exists, the entry 
corresponding to the mainpin in DSXREF table contains the 
following : 



l 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 



RCW 



LCW 



SIOQW 



:|„|„|«|==l= = 

)\ | |PB| REQ. 



= |==|==|==h 



.|«|«|»h 



:|==|: 



save IOQ 



STATE j Slave Pseudo Term LDEV 



l==l==l==l==l==l==l==l==h 

| UC number 
,|..|..|«|«|„|«|„|«|. 



==I==I==I==I==I==I==I==I==P 
index ( PTOP break ) 
==I==I==I==I==I==I==I==I==P 



Notes : 

R - Request in progress 

PB - Current break request issued by PCLOSE break 
Num. son proc. - Current number of sons processing 
DSbreak (Break, Abort, Resume). 

REQ. STATE - 

Master or Slave Master States 



= Command Out 

1 = PTOP Out 

2 = PTOP in break mode reply pending 

3 = PTOP in break mode, flow issued 
k = PTOP in break mode 

5 = PTOP in break, resume issued 

6 = PTOP in break, saved IOQ on line 

7 = PTOP in break, abort issued 



Slave States 



= Null 

1 = PTOP in break 

2 = PTOP in break flow not issued 

3 = PTOP in break flow issued 

k = PTOP in break Resume/Abort received 
5 = PTOP in break PCLOSE BREAK received 
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DSDEVICE 
1 2 3 U 5 6 7 8 9 10 11 12 13 lit 15 



=l==l==l==l==l==i==l i 



NUMBER OF REAL ENTRIES 



ENTRY SIZE 



(-D 
( 0) 



DSDEVICE TABLE ENTRY 
1 2 3 h 5 6 7 8 9 10 11 12 13 1U 15 
I I DEV. SUB. | DEVICE TYPE| 



NOTES 

The DSDEVICE table is initialized during system startup to 
contain a device type corresponding to the device's 
relationship to DS/3000, and a device subtype (DS1 or DS1.5). 
The number of real entries corresponds to the number of LDEVs 
configured for the system. Entry size is one word. 

DEVICE TYPES: 

= Non DS/3000 related device. 

1 = DS/3000 related CS device. 

2 = DS device. 

3 = DS pseudo terminal. 

U = DS PAD pseudo device. 

DEV. SUB. = DEVICE SUBTYPES: 

= DS1 

1 = DS1.5 (X25) 
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DS LPDT ENTRY 



?0 1 2 3 h 5 6 7 8 9 10 11 12 13 lb 15 

i i i i i i i i i i i =t= I ■ = =_ i = ■ = = ■ «= = ■ 

i == i == i == i == i -= i == i — i — i — i " i == i — i =- i -= i ~ i — i 
| //| DIT pointer (SYSDB- relative) | 
| | 

|STATE!JA|DA|CY|DU|IN! EOF |BR| C| SUBTYPE | 



STATE 



J 

DA 
CY 
DU 

IN 

EOF 



Device recognition state 
(For DS device) 

- Available (for use) 

1 - Not available 

2 - :DSCONTROL device lock 

3 - not used 



(For virtual terminal) 
Available (not owned) 
Owned or recognized 
DEVREC service request 
DEVREC service granted 



(For virtual terminals only) 

Job accepting 

Data accepting 

Control Y detected 

Duplicative 

Interactive 

(For DS device) Remote side can compress data 

End of file condition 

- No :EOF 

1 - Hardware EOF 

2 - :DATA 

3 - :E0D 

It - : HELLO 

5 - :BYE 

6 - :JOB 

7 - :EOJ 



BR - (For virtual terminal) Break detected 

(For DS device) DSMON not created 
C - Default is data compression. 
SUBTYPE - (For DS device) 

- default is no data compression 

1 - default is data compression 
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IODSO DIT 



l 2 3 k 5 6 7 8 9 10 11 12 13 lit 15 



#0 


l==l 

1 o| 


==|==l==l==l== 
0| A|NR| Q| 


==l==l==l==l==l==l==l==l 
P| | D| N|PS|STATE| X| 


M| S 


1 %o 


1 


I NEXT DITP (ALWAYS 0) 


1 1 


2 


1 IOQP 


i 2 


3 




UNIT NUMBER 


I LDEV 




! 3 


k 


DLTP 


1 k 


5 


SAVEIOQ 


1 5 


6 


USECOUNT 


6 


7 




CS LDEV 


| FWDLDEV 




7 


8 




HDLEN 


| MSG CLASS 




10 


9 





11 


10 


Rl 


E| C| B| 


| STREAM TYPE 




12 


11 


SUBSTREAM 


13 


12 




FROM PROCESS 


| TO PROCESS 




1U 


13 


RTE TIME STAMP 


15 


Ik 


MULTI-PACK ACTL 


RECV CNT (APND+DATA/+BYTES) 


16 


15 




DATA 


LENGTH (+ BYTES) 




17 


16 


HDX1 /TEMPI 


20 


17 


HDX2/TEMP2 


21 


18 | 


HDX3/TEMP3 


22 


19 1 


DSIOM DELAY PARMS j 


23 


20 




MORE 


DSIOM DELAY PARMS 




2k 


21 | 


DSXREF TEMP | 


25 


22 | 


CR|RS|RE|RM|//| REMOTE'S DS CAP. MASK (WORD) | 


26 
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IODSO DIT NOTES 

A - Monitor is currently executing 

NR- New request has occurred while processing 

Q - X21 Queued flag 

P - Pre-emptive 

R - Reply 

E - Reject 

C - Continuation 

B - Break mode 

D - DSMON request bit 

N - Keeps DSIOM delay in effect (NULLF) 

PS- Primary /Secondary CSline 

CR- Capability mask reply bit 

RS- Remote can use sequence numbers 

RE- Remote can use exclusive mode w/o excl. protocol 

RM- Remote supports multi-packet algorithm 

STATE - CSline state 

= unconnected 

1 = control 

2 = text 

X - Exclusive mode valid if set. 
M - Master mode valid if set. 
S - Slave mode valid if set. 



Note: Bits and 1 of the IODSO DIT must be to fit MPE 10 system 
conventions. 
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IODSX DIT 
l 2 3 k 5 6 7 8 9 10 11 12 13 l 1 * 15 



# o| 


==l 
0| 


"1 
0| 


==|==l==l==l==l==l==l==l==l==l==l==l==l==l 
A| N| | | P| | | | I I I X| | | 


%0 DFLAG 


11 


NEXT DITP 1 


1 DLINK 


2| 


IOQP ! 


2 DIOQ 


31 


UNIT NUMBER | LDEV 


3 DLDEV 


M 


DLTP i 


U DDLTP 


51 


SAVEIOQ 


5 SAVEIOQ 


61 


USECOUNT 


6 DUSECOUNT 


71 


CS LDEV | FWDLDEV 


7 DLINKDEV 


81 


T| 




TIME OUT COMPLETED FLAGS 


10 DTIMWD 


91 


TIMER REQUEST INDEX 


11 DTIMINDEX 


10 1 


DSX DATA SEGMENT DST # 


12 DXDST 


111 


HDLEN | MSG CLASS 


13 DXHEADR 


12 1 


USER CHANNEL NUMBER 


Ik 1-HDUC 


131 


Rl 


E| 


C| B| | STREAM TYPE 


15 2-HDSTRMTYP 


1U| 


SUBSTREAM TYPE 


16 3-HDSUBSTRM 


151 


FROM PROCESS | TO PROCESS 


17 U-HDPROCN 


16 1 


RTE TIME STAMP 


20 5-HDRTE 


171 





21 6- 


18 


DATA + APPENDAGE LENGTH 


22 7-HDMSGLEN 


19 


HDX1 /TEMPI 


23 10-HDX1 


20 


HDX2/TEMP2 


\2k 11-HDX2 


21 


HDX3/TEMP3 


|25 12-HDX3 


22 


REMOTE DS LEVEL NUMBER 


|26 


23 


MONG/ MONP/ GETQ/ PUTQ BUFFER AREA 


1 27 


2U 


BUFFER AREA (1) 


130 
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44 



BUFFER AREA (21) ! 5- 



..i..i. a |. S |..i..i--i»i«i--i--i--i"i"i--i-- 

1 2 3 h 5 6 7 8 9 10 11 12 13 lU 15 



NOTES 

A => MONITOR CURRENTLY EXECUTING IF = 1 

N => A NEW REQUEST HAS BEEN RECEIVED WHILE EXECUTING IF 

P => PRE-EMPTIVE 

X => EXCLUSIVE MODE IN EFFECT IF = 1 

R => REPLY 

E => REJECT 

C => CONTINUATION 

B => BREAK MODE 

HDLEN = HEADER + APPENDAGE LENGTH IN WORDS 
HDMSGLEN = DATA + APPENDAGE LENGTH IN BYTES 

DFLAG.(15:1) = 1 , indicating a IODSX DIT. 

This bit is reset when the first 
DSINIT does its work. 

Bit and 1 of the IODSX DIT must he to fit MPE 10 
system convention. 
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IODSTRMO DIT 
1 2 3 k 5 6 7 8 9 10 11 12 13 Ik 15 



#0 

1 

2 
3 
U 
5 
6 

7 
8 

9 
10 
11 
12 
13 
Ik 

15 
16 

17 



T | B| |SY| A|MC|CB| D| 


F| S| L| E| R| P| 


NEXT DITP 


IOQP 


UNIT NUMBER | 


LDEV 


DLTP 


SAVEIOQ 


SYSBUFADR 


DS LDEV | 


FWDLDEV 


M| | 


TDSTN 


IMAST. STATE | 


MASTER LDEV 


MESSAGE CLASS 


| STREAM TYPE 


FROM PROC | 


TO PROC 


RTE TIME STAMP 


RESERVED FOR X 


25 


RESERVED FOR X 


25 


RESERVED FOR X 


25 


RESERVED FOR X 


25 


PRINT BUFFER SIZE ON 


MASTER SYSTEM 



%0 

1 

2 
3 
k 

5 
6 
7 
10 
11 
12 
13 
Ik 

15 
16 

17 
20 
21 
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NOTES 
T - Terminal 
B - Break 
SY - System Read 
A - Session being aborted 
MC - Master is compressing 
CB - Clear break (CLRBRK) 
D - Read abort 
F - Flush 
S - Session 

L - LOGF (Set during logon process) 
E - Tells terminal driver that line error occurred 
R - SYSLOADF (RTE down load in progress) 
P - Prompted 
- Pending 
M - Terminal pre-empt 
TDSTN - Slave DS extra data segment 
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IODSTRMX DIT 
1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 



# o| 


==|==l==l==l==l==l==l==l==l==l==l«l==l==l==l== 
T|TB|EX|RT| 0| A|MC|CB| | F| S| |TE|CL| P|TT 


1 






NEXT DITP 


2 






IOQP 


31 






UNIT NUMBER | LDEV 


M 






DLTP 


51 






SAVEIOQ 


6| 






SYSBUFADR 


71 






DS LDEV | FWDLDEV 


81 


M| 




| TDSTN 


9! 






RCW (SLAVE MASTER) 


10 1 


Rl 


E| 


C| B| MESSAGE CALSS | STREAM TYPE 


ll| 




FROM PROC | TO PROC 


12 1 






RTE TIME STAMP 


131 


USER 


CHANNEL TYPE | USER CHANNEL I.D. 


1U| 


X. 


25 


XDS OFFSET TO TERMINAL DIT EXTENSION 


151 






LCW (SLAVE MASTER) 


16 1 






SIOQW (SLAVE MASTER) 


171 






PRINT BUFFER SIZE 


18| 






PRINT IOQ 


191 






PRINT BUFFER POINTER 


20 1 






FCLOSE IOQ 



%0 DFLAG 

1 DLINK 

2 DIOQ 

3 DLDEV 
U DDLTP 

5 SAVEIOQ 

6 SYSBUFAD 

7 DLINKDEV 

10 TDSTN 

11 TMSTR 

12 TCLSTYP 

13 TPROCN 
lU TRTE 

15 TCHANID 

16 TXDSTOFF 

17 TLCW 

20 TSIOQW 

21 TPBUFSZ 

22 TPIOQ 

23 TPBUFPNTR 
2U TFCLOSEIOQ 
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IODSTRMX DIT NOTES 



T => 


TERMINAL = 1 


TB => 


TERMIANL BREAK 


EX => 


EXPANSION REQUEST IN PROGRESS (PRINT) 


RT => 


INCOMING RESET REPLY PENDING 


A => 


SESSION BEING ABORTED (ABORT JOB) 


MC => 


MASTER IS COMPRESSING (not used) 


CB => 


CLEAR BREAK (CLRBRK) 


F => 


FLUSH 


S => 


SESSION 


TE => 


TERMINAL ERROR (LINE ERROR) 


CL => 


INCOMING CLEAR REPLY PENDING 


P => 


PROMPTED 


TT => 


PS TERMINAL TYPE 




= IF DS PSEUDO TERMINAL 




■ 1 IF DS PAD PSEUDO TREMINAL 


=> 


PPENDING 


M => 


TERMINAL PRE-EMPT 


R => 


REPLY 


E => 


REJECT 


C => 


CONTINUATION 


B => 


BREAK MODE 


TDSTN 


- SLAVE DS EXTRA DATA SEGMENT 
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« PAD TERMINAL DEVICE INFORMATION TABLE (DIT) » 



==|==l==l==l==l==l==l==l==l==l==l==l==l==l==l== 

1 I UP | AC | | |AB| | IC | SL j RS | IP | E I | Xc | LD i P |1 

NEXT DIT POINTER (SYSDB-RELATIVE) 
SYSDB-REL PTR TO FIRST IOQ ELEMENT ON DIT 
F1|NE|NP| UNIT NUMBER | LDEV 
DLTP: SYSDB-REL PTR TO DS LOGICAL DEVICE TABLE 


| | | | | | | |RT| |DC|LT|Br|Es|EF| 
DS LDEV | FWD LDEV 

PT|Tr|PC|PF| PTY |LO|RB|Edit in |TMode|LP lev 
TERMINAL TYPE |Ec| LogTp|EO|BO|TR|Ti|Bl 
PAD TERMINAL EXTRA DATA SEGMENT DST# 
Utility/temporary storage 
CURRENT PAD TERMINAL XDS SIZE 
USER CHANNEL NUMBER (0-255) 
NO. WORDS AVAILABLE IN READ BUFFER 
EOFCHECK BUFFER WORD 1 
EOFCHECK BUFFER WORD 2 
EOFCHECK BUFFER WORD 3 

DST# PREMPTIVE PRINT PARITY CHANGE BUFFER 
MAXIMUM READ TIME (in seconds) 
READ TIME (1st word of double timers) 
(2nd word of double timers) 
DEF TERMTYPE | |DSPEED 
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1 
2 
3 
k 

5 

6 DRQST 

7 

8 DMODEM 

9 

10 

11 

12 

13 

111 

15 
16 

17 
18 

19 
20 
21 
22 
23 



USER CHANNEL NUMBER ! 
REQUEST CODE /STATUS 


IOQ INDEX i 


OUTGOING HEADER DST NUMBER 


OUTGOING HEADER OFFSET 


OUTGOING BYTE COUNT (+BYTES) 


INCOMING HEADER DST NUMBER 


INCOMING HEADER OFFSET 


INCOMING HEADER BYTE COUNT (+BYTES) 


OUTGOING APPENDAGE DST NUMBER 


OUTGOING APPENDAGE OFFSET 


OUTGOING APPENDAGE + BYTE COUNT 


INCOMING APPENDAGE DST NUMBER 


INCOMING APPENDAGE OFFSET 


INCOMING + BYTE COUNT 


OUTGOING DATA DST# 


OUTGOING DATA OFFSET 


OUTGOING + BYTE COUNT 


INCOMING DATA DST# 


INCOMING DATA OFFSET 


INCOMING + BYTE COUNT 


USER MAIN PROCESS ID# 


MTTT.TTPAGE WRITE BUFFER DST# 


MULTIPAGE WRITE BUFFER WORD LENGTH 
MULTIPAGE WRITE BUFFER 1 DST# 


MULTIPAGE WRITE BUFFER 1 WORD LENGTH 


BW| |WBUFO|WBUF1|NOB |F1|A1|F0| A0|R1|R0| 

. ... M 



21+ 

25 
26 

27 
28 
29 
30 
31 
32 
33 
31+ 
35 
36 
37 
38 

39 

i+o 

1+1 
1+2 

1+3 
1*1+ 

1+6 
1+7 
1+8 

1*9 
50 
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BYTES OF WRITE DATA IN BUFFO READ XDS 
BYTES OF WRITE DATA IN BUFFI READ XDS 
BYTES OF WRITE DATA IN MULTIPAGE WRITE BUFFO 
BYTES OF WRITE DATA IN MULTIPAGE WRITE BUFFI 
SI | | Prev. Req. Func. Code 

Previous request IOQ QPAR1 (usually for write) 
Previous request IOQ QPAR2 (usually for write) 

Timer request list number 

SS Break Character | Record End Character 

STORED READ DST NUMBER 

STORED READ OFFSET 

STORED READ POSITIVE BYTE COUNT 



51 
52 
53 
5U 
55 
56 
57 
58 

59 
60 
61 
62 
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<< 




<< 


0:1 


<< 


2:1 


<< 


5:1 


<< 


7:1 


<< 


8:1 


<< 


9:1 


<< 


10:1 


<< 


11:1 


<< 


12:1 


<< 




<< 


13:1 


<< 




<< 




<< 


lU:l 


<< 




<< 
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DIT FIELDS AND THEIR MEANINGS 



EQUATE GETQ'OFFSET'IN'DIT = 2U; 
EQUATE DIT' STATUS 'WORD = 0; 

«The O'th DIT word contains the following flags and>> 

<<status bits: >> 

>> 

1, indicating a pseudoterminal >> 

1, indicating driver is active >> 

1, set by DSKILLJOB to mean ABORTJOB done>> 
1, interrupt received, owe 'resume output >> 
1, suppress CR/LF after a read >> 

1, reset request received, not processed >> 
1, set initial PAD parameters for logon >> 

0, echo !!! after CTRL X » 

1, means a read was cancelled by CTRL X >> 
and must be restarted >> 

1 if a line disconnect has been sent >> 
from the network. >> 

>> 

1, if prespace carriage control in write >> 

0, if postspace carriage conts. in write >> 

1, indicating a PAD pseudoterminal >> 

DEFINE DIT'DRIVER' IS 'ACTIVE = PAD'DIT'ARRAY(DIT'STATUS'WORD) . (2:1)#; 

<<If set, the driver is working on another request when called. >> 

DEFINE INTERRUPT 'NEEDS 'ACTION= PAD 'DIT 'ARRAY. (7:1)#; 

DEFINE SUPPRESS 'CR'LF' AFTER 'READ 

_ pad 'DIT' ARRAY ( DIT ' STATUS 'WORD ).(8:1)#; 

<<If set, suppress CR/LF after a read. This is passed to the >> 

<<driver via a read IOQ. This is set using FSETMODE intrinsic. >> 

DEFINE LINE 'RESET 'REQUESTED = PAD'DIT'ARRAY(DIT'STATUS'WORD) . (9:l)#; 

<<Set when the completor finds a request for a line reset. >> 
<<The initiator responds to the request. >> 

DEFINE SET 'INITIAL' PAD 'PARMS = PAD'DIT'ARRAY(DIT'STATUS'WORD) . (10:1)#; 

<<Set when the completor detects a terminal logging on. The >> 
« initiator then sends a PAD message to initialize the PAD >> 
<<parameters. ** 

DEFINE CONTROL 'X 'ECHO 'ON = PAD 'DIT' ARRAY (DIT'STATUS' WORD ). (11:1) #; 

<<If set, the driver initiator will send a !!! to the terminal >> 
<<after a control X is sent from the terminal. >> 



DEFINE CONTROL 'X 'RESTART 'READ 

= PAD'DIT'ARRAY(DIT'STATUS'W0RD).(12:1)#; 
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DEFINE DIT'PRESPACE'BIT = PAD 'DIT 'ARRAY (DIT 'STATUS 'WORD) . (lU:l)#; 
<<This bit is set when carriage control characters are to be>> 
<<sent before the write data itself. >> 

DEFINE LINE 'DISCONNECTED 

= PAD 'DIT 'ARRAY (DIT 'STATUS' WORD ).( 13: 1)#; 



EQUATE SYSDB'REL' NEXT 'DIT 'POINTER = 1; 

<<This DIT word contains the SYSDB-relative offset to>> 
<<the next DIT. This is usually 0. It is only used >> 
<<when several DIT's are using the same system >> 
<<resource. >> 

EQUATE SYSDB'REL 'IOQ' POINTER = 2; 

<<The first DIT words contains the SYSDB- relative » 
<<offset to the first IOQ element associated with >> 
«this DIT. » 

EQUATE UNIT' NUMBER 'LDEV = 3; 

<<The third word of the DIT contains the unit number >> 
<<and the logical device number of this terminal. The>> 
<<unit number is assigned by SYSDUMP. >> 

DEFINE FLUSH = (0:l)#;<<When set, flush writes and return will » 

<<have IOQ status 0; reads completed with>> 
<<I0Q status = %173- Keep doing this for» 
<<all requests until a request 25, clear >> 
<<flush and write is received. >> 

DEFINE LDEV = (8:8)#; 

EQUATE SYSDB 'REL'DLTP = U; 

<<The fourth word of the DIT contains the SYSDB » 
<<relative offset to the DS logical device table. >> 

<<The fifth word of the DIT contains a 0. This is >> 



<<expected by POWERFAIL. 



EQUATE DRQST = 6; 

DEFINE READ'TIME'OUT = PAD'DIT'ARRAY(DRQST) . (8:1)#; 

<<This bit is set by TIMERREQ if a timer has expired 
<<on a timed read request. It is reset by driver 
<<if the read was completed in time. 

DEFINE DATASEG' CLEANUP = PAD'DIT'ARRAY(DRQST) . (10:1)#; 

<<This bit is set after a logon timeout has expired 
<<following a :BYE - we can finally release the PAD 
<<XDS when we get to the completion section. 



21-2U 



>> 



DEFINE LOGON' TIME 'OUT = PAD 'DIT' ARRAY (DRQST) . (11:1)#; 

<<This bit is set by TIMERREQ if a timer has expired >> 
<<for a logon timeout. It is reset by the driver if the>> 
<< logon came in time. >> 

DEFINE IN 'BREAK 'STATE = PAD' DIT 'ARRAY (DRQST) . (13:1)#; 

<<This bit, if set, indicates that break was allowed >> 
<<and was found. This bit is only set by an IOQ with >> 
<<a function code of 30. If QPAR1 of this IOQ is odd, >> 
<<the break state is set. If QPAR1 of this IOQ is even,>> 
<<the break state is reset, i.e., end of break state. >> 
<<This is issued via a direct ATTACHIO from the command >> 
<< interpreter. ** 



EQUATE OTHER 'LDEVS = 7; 

«The left eight bits are the ldev of the DS device. The right» 
<<eight bits are the forward pointer to the next DS logical >> 
«device. DSINIT fills these fields. » 



EQUATE DMODEM = 8; 

DEFINE DIT 'PREEMPT 'BIT = PAD 'DIT 'ARRAY (%10) . (0:1)#; 

<<This bit is set when a pre-emptive print is >> 
<<posted to this DIT. The IOQ is reordered. >> 



DEFINE TIME'UP = PAD 'DIT 'ARRAY (DMODEM) . (1:1)#; 

<<This bit is set when a timer request expires and the >> 

<<driver is awakened. This usually happens when a >> 

<<conversational write is waiting for the next request >> 

<<to actually send the write data. The timer request >> 

<<is made to be sure that the data is sent even if no >> 

<<further request is made or the system is too slow. >> 

<<It is reset either when the driver is called for a >> 
<<new write or read request or the driver sends out the>> 

<<write data anyway. >> 

<<The procedure TIMEREQ requires this bit be in this >> 

<<word. This bit position is specified by the %21 >> 

<<value of the first parameter of TIMEREQ. >> 

DEFINE PARITY 'CHECK = PAD 'DIT 'ARRAY (DMODEM) . (2:l)#; 

<<If set, this indicates that driver will check incoming>> 
<<parity and generate outgoing parity. >> 

DEFINE PARITY'FOUND = PAD'DIT'ARRAY(DMODEM) . (3:1)#; 

<<If set, this indicates that the driver has determined >> 
<<the parity of the remote terminal. >> 
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DEFINE PARITY = PAD 'DIT 'ARRAY (DMODEM) . (U:2)#; 

<<This holds the value of the parity which was determined>> 

<<by the driver procedure FIND'PARITY. » 

<< >> 

<< 0: Parity bit is always 0; >> 

<< 1: Parity bit is always 1; >> 

<< 2: Parity is even; >> 

<< 3: Parity is odd; » 

<< >> 

<< Note that this driver only supports and 3. »> 

DEFINE TERMINAL' LOGGED' ON = PAD 'DIT 'ARRAY (DMODEM) . (6:1)#; 

<<This bit is set when the terminal is logged on. It is >> 

<<initially set to and is reset to whenever the >> 

<< there is a log off. >> 

DEFINE READ 'DATA 'BUFFERED = PAD 'DIT 'ARRAY (DMODEM) . (7:l)#; 

<<This bit is set whenever there is read data which has >> 

<<been buffered awaiting a read. This happens when the >> 
<<terminal has received a logon message, but the terminal>> 

<<has not yet been logged on. It also occurs when an >> 
<<end of file was found and data must be buffered for the>> 

<<the next read. This is changed by the procedure >> 

<< called STORE' INCOMING 'MESSAGE. The address of the » 

<<stored data and its byte length are stored in the DIT. >> 

DEFINE EDIT'INPUT = PAD 'DIT 'ARRAY (DMODEM) . (8:3)#; 

<<If 0, don't edit any incoming data characters. >> 

<< 1, edit incoming data. >> 

<< possibly other cases >> 



EQUATE TERM 'INFO = 9; 

DEFINE USER 'TERM 'TYPE = PAD 'DIT 'ARRAY (TERM 'INFO) . (0:8)#; 

DEFINE LOGON'TYPE = PAD 'DIT 'ARRAY (TERM 'INFO) . (9:2)#; 

<<This contains the logon type. It is determined >> 

<<by an IOQ with function code 21. It values are as >> 

<<follows: >> 

<< >> 

DATA, break not enabled. 
SESSION, break enabled. 

JOB, break not enabled. >> 

<< >> 

<<When these are set, the logon timeout is stopped. >> 



« 
<< 1 
<< 2 



>> 
>> 



DEFINE ECHO 'SETTING = PAD 'DIT' ARRAY (TERM' INFO) . (8:1 )#; 

<<If 0, allow PAD to echo terminal input. >> 

<<If 1, don't allow PAD to echo. >> 

DEFINE CONTROLY'OK = PAD 'DIT 'ARRAY (TERM 'INFO) . (11:1)#; 

<<If this bit is set, subsystem break is enabled. >> 

<<Note that the subsystem break character need not >> 

<<be EM (control Y). This bit is set by an IOQ with >> 
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<<function code 13 (fcontrol 17). The bit is reset » 

<<by an IOQ with function code 12 (fcontrol 16). >> 

<<These bits are changed in the initiator but provide >> 

<< control information to the completor. » 

DEFINE BREAK'OK = PAD 'DIT' ARRAY (TERM* INFO) . (12:1)#; 

<<If this bit is set, the driver will allow system >> 

<<break to take place. This will be signalled to the >> 

<<the driver by a level interrupt packet to a level >> 

<<1 indication of break PAD message. >> 

<<This bit is set by an IOQ with function code 11 >> 

« (fcontrol 15). It is reset by IOQ function 10, >> 

« (fcontrol 16). » 

DEFINE READ'TIMER'ON = PAD' DIT' ARRAY (TERM' INFO) . (lU:l)#; 

<<If this bit is set by an IOQ with function code 17 » 

<<the time since the last read is being stored in the >> 

<<DIT to be returned when an IOQ with a function 18 >> 

<<is found. This bit is reset by function codes 16 >> 

«and 18. » 

DEFINE READ'TIMEOUT 'ENABLED = PAD'DIT'ARRAY(TERM'INFO) . (13:1)#; 
<<If this bit is set by an IOQ with function code 5» ** 
<<all reads are to be timed out. The time out value >> 
<<is stored (as seconds) in word 20 of the DIT. If >> 
<<QPAR1 of an IOQ with function code 20 is 0, this bit» 
<<will be reset, indicating that there is no timeout » 
<< interval. » 

DEFINE BLOCK'MODE = (15:1)#; 

<<If this is 1, the terminal is in block mode; if the>> 
<<terminal is in character mode. >> 



EQUATE PAD' TERMINAL 'XDS'DST = 10; 

<<This word contains the DST number of the PAD terminal>> 
<<extra data segment. >> 

EQUATE UTILITY = 11; 

DEFINE DIT'UTILITY'WORD = PAD'DIT'ARRAY(UTILITY)#; 

<<This word is a utility word used to transfer single >> 
<<words between data segments. It is in the DIT so >> 

<<+.h»+. the DR rnffi st.pr eicics nnt. have +.0 h*» r«»+. -ho the >> 
— .— — — — 

<<stack to use a local variable. In general, when a >> 
<<single byte must be transferred from one data area >> 
<<area to another, a whole word is moved to this place >> 
<<and the unwanted byte is removed before the remaining>> 
<<byte plus a null byte is moved to the final location. >> 
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EQUATE CURRENT'PAD'TERMINAL'XDS'SIZE = 12; 

<<This word contains the current number of words which >> 
<<are available in the PAD terminal extra data segment. >> 



EQUATE USER 'CHANNEL' NUMBER = 13; 

<<This word contains the user channel number for the >> 

<<the current session. It maximum value is 255> >y 

<<DSIOMX assumes that the word in this position has the UC. >> 

DEFINE USER'CHANNEL = PAD'DIT'ARRAY(USER'CHANNEL 'NUMBER)*; 



EQUATE NO 'WORDS' IN 'FREE 'R'W' BUFFER = lU; 

<<This word contains the CURRENT number of words that >> 

<<can be placed in the free read/write buffer of the >> 

<<the PAD terminal extra data segment. >> 



EQUATE EOF' CHECK '1 'WORD = 15 
EQUATE EOF 'CHECK' 2 'WORD = 16 
EQUATE EOF 'CHECK '3 'WORD =17 

<<These three words will hold copies of the first three>> 
<<words of incoming data. They will be examined by >> 
<<the procedure EOFCHECK to determine if they contain >> 
<<an end-of-file indication. >> 



<<WORD 18 IS UNUSED PRESENTLY. ITS VALUE IS 0. » 

EQUATE PARITY 'CHANGE 'BUFF = 19; 

DEFINE PRE 'EMPT' PARITY 'CHANGE 'BUFFER = 

PAD 'DIT 'ARRAY ( PARITY ' CHANGE ' BUFF )#; 

<<This word contains the DST number of an extra data >> 
<<segment obtained to buffer data while changing the >> 
<<parity of pre-emptive prints. This is only acquired >> 
<<when even parity has been detected in incoming logon >> 
<<data. It is released with a device close IOQ. >> 



EQUATE READ' MAX 'SECONDS = 20; 

DEFINE MAXIMUM 'READ 'SECONDS = PAD'DIT'ARRAY(READ'MAX'SECONDS)#; 

<<This word contains the number of seconds allowed for a>> 
<<timed read. The value is derived from the IOQ(QPARl) >> 
<<field of a request with function code 5, i-e-» set >> 
<<read time out. >> 
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EQUATE READ' TIME' 1 = 21; 
EQUATE READ'TIME'2 = 22; 

<<These two words are used to hold the timer value >> 

<<for the time taken to complete a read request. >> 

<<The double word logical value is determined by the >> 

<<TIMER intrinsic. This value is read by an IOQ >> 

<<request with function code 18. >> 

EQUATE INITIAL 'TERMTYPE' AND 'SPEED = 23; 

<<This word contains the terminal type and speed the >> 

<<is set by INITIAL. The user terminal type is held >> 

<<in word labelled TERMINFO. » 



« WORDS 2k THROUGH U5 ARE USED FOR FORMATTING THE GETQ » 
<< ELEMENT. THESE ARE DEFINED EARLIER IN THIS LISTING. » 



GETQ 'ELEMENT' LENGTH = 22, Length of a GETQ element in words 

The following offsets refer to the GETQ formatting 
area in the PAD terminal DIT. 
The values below are DIT relative offsets. 

GETQ'UC'WORD = 2k, <<This holds the user channel #» 
GETQ 'REQ' STATUS 'WORD = 25, «This holds the request /status » 

<<word for the current request >> 
<<in bits (8:15) for requests >> 
<<with IOQ index: >> 

<< >> 

<< Code Meaning Data >> 
<< >> 

<< 3 UC clear clear parms.>> 

<< k UC 10 level data » 

« 5 UC 10 level 1 data » 

<< >> 

<<Bit positions (0:8) are used » 
<<to specify the EOR character » 
«for DSMONX: » 

<< >> 

<< CR: » 

<< RS: 1 » 

<< any non-printing » 

<< character : 2 » 

<< >> 

<<For responses to requests >> 

<<that don't have an IOQ, the >> 

<<status to the request is >> 

<<coded as follows: >> 

<< >> 

« 3: incoming clear completed >> 
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>> 
>> 



GETQ ' IOQ ' INDEX * WORD 

GETQ'O'H'D'l 

GETQ'O'H'D'2 
GETQ'O'H'D'3 

GETQ'I'H'D'l 

GETQ'I'H'D'2 

GETQ'I'H'D'3 

GETQ'O'A'D'l 

GETQ'O'A'D'2 

GETQ'O'A'D'3 

GETQ'I'A'D'l 

GETQ'I'A'D'2 

GETQ'I'A'D'3 
GETQ' OUT' DST 
GETQ'OUT'OFFSET 
GETQ ' OUT ' DATA ' COUNT 

GETQ' IN 'DST 
GETQ' IN 'OFFSET 
GETQ'IN'DATA'COUNT 



<< U: incoming interrupt 

< < completed 

<< $: incoming reset completed >> 

26, <<The IOQ index of the current >> 
<<request being formatted >> 

27, <<This holds the first header >> 
"descriptor; >> 



28, «The second header 
"descriptor 

29, <<The third header 
<< descriptor 



>> 

>> 
>> 
>> 



30, "Holds the incoming descriptor>> 
<<for the header >> 



31, <<Holds incoming header 
"descriptor 

32, <<Holds incoming header 
"descriptor 



>> 
>> 



>> 
>> 



33, "Holds the outgoing appendage >> 
"descriptor >> 

3U, "Holds the outgoing appendage » 
<<descriptor >> 

35, <<Holds the outgoing appendage >> 
<<descriptor >> 

36, <<Holds the incoming appendage >> 
"descriptor >> 

37, "Holds the incoming appendage >> 
"descriptor >> 

38, "Holds the incoming appendage >> 
"descriptor >y 

39, "Holds the source DST# for >> 
<< outgoing data >> 

UO, "Holds the offset for outgoing>> 
"data ** 

Ul, <<Holds the data count for >> 
"outgoing data in + bytes >> 



U2, "Holds the target DST# for 

<< incoming data 
U3, "Holds the target offset 

"for incoming data 
I4I4, "Holds expected data 

<< count in + bytes 

"for incoming data 



>> 
>> 
>> 
>> 
>> 
>> 
>> 
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GETQ'MAINPIN = i»5 <<User main process number » 

<<This is not needed now, but » 

<<may have to be used later. » 

<<Its value is returned in the » 

<<corresponding PUTQ. It will » 

<<be set to zero for now. >> 
EQUATE BUFFO' DST'MULTIPAGE 'WRITE = U6; 

<<This word holds the DST# of the buffer used to store» 
<<outgoing multipage VIEW writes. >> 

EQUATE BUFFO 'LENGTH 'MULTIPAGE 'WRITE = kj; 

<<This word holds the word length of the buffer for >> 
<<outgoing multipage VIEW writes. >> 

EQUATE BUFFI 'DST'MULTIPAGE 'WRITE = U8; 

«This word holds the DST# of the buffer 1 used to store>> 
<<outgoing multipage VIEW writes. >> 

EQUATE BUFFI' LENGTH 'MULTIPAGE 'WRITE - U9; 

«This word holds the word length of the buffer 1 for >> 
<<outgoing multipage VIEW writes. >> 



EQUATE BUFFER' STATUS' MULTIPAGE = 50; 

<<This word holds status information concerning the use >> 
<<of the multipage write buffers and the read buffer >> 
<<extra data segment with the fixed length write buffers >> 

<< >> 

<<Meaning of the fields: >> 

<< >> 

<< 8:2 Next outgoing write buffer » 

<< Values: >> 

<< >> 

<< 0: buffer in read extra data segment >> 

<< 1: buffer 1 in read extra data segment >> 

<< 2: multipage write buffer >> 

« 3: multipage write buffer 1 >> 

« U:2 Write buffer status » 

« 6:2 Write buffer 1 status >> 

<< Values: » 

<< >> 

<< 0: buffer empty (available) » 

<< 1: data buffered - waiting for next req. >> 

<< 2: data shipped - waiting for completion >> 
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DEFINE WR'BUFO'STAT = 

PAD'DIT'ARRAY(BUFFER'STATUS'MULTIPAGE) . (U:2)#; 

DEFINE WR'BUFl'STAT = 

PAD'DIT' ARRAY (BUFFER' STATUS' MULTIPAGE) . (6:2)#; 

DEFINE NEXT' OUTGOING 'WRITE 'BUFFER = 

PAD'DIT'ARRAY(BUFFER'STATUS'MULTIPAGE) . (9:l)#; 

EQUATE WR' BUFFO 'XDS = 51; 

<<This word holds the number of bytes of outgoing write » 
<<data stored in buffer 0. >> 

DEFINE WRITE 'BUFFO 'XDS = PAD'DIT'ARRAY(WR'BUFFO'XDS)#; 

EQUATE WR' BUFFI 'XDS = 52; 

«This word holds the number of bytes of outgoing write >> 
«data stored in buffer 1. >> 

DEFINE WRITE 'BUFFI 'XDS = PAD'DIT' ARRAY(WR'BUFF1'XDS)#; 

EQUATE WR' BUFFO 'BYTES = 53; 

<<This word holds the number of bytes of outgoing write >> 
<<data stored in write buffer 0. >> 

DEFINE WRITE 'BUFFO 'BYTES = PAD ' DIT' ARRAY (WR' BUFFO 'BYTES)#; 

EQUATE WR' BUFFI 'BYTES = 5U; 

<<This word holds the number of bytes of outgoing write » 
<<data stored in write buffer 1. » 

DEFINE WRITE 'BUFFI 'BYTES = PAD'DIT'ARRAY(WR'BUFF1'BYTES)#; 

EQUATE PREV'QFUNC = 55; 

<<This word holds the previous request function code in» 
<<its left 8 bits. This is used for conversational » 
<<write/read requests. Usually it is a previous read » 
« function = 1. >> 

DEFINE PREVIOUS 'FUNCTION 'CODE = PAD 'DIT 'ARRAY (PREV'QFUNC) . (8:8)#; 



EQUATE PREV'QPARl = 56; 

<<This word holds the IOQ QPAR1 parameter value from >> 
<<the previous request, usually a write. This is also >> 
<<used to make conversational GETQ requests. It >> 
<<usually holds formatting information for the previous>> 
<<write request that has already had its IOQ returned. >> 

DEFINE PREVIOUS 'QPAR1 = PAD 'DIT' ARRAY (PREV'QPARl)*; 

EQUATE PREVQPAR2 = 57; 

«Like the word above, it holds the value of IOQ QPAR2 » 
<<parameter for the same purpose. >> 
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DEFINE PREVIOUS' QPAR2 = PAD'DIT'ARRAY(PREV'QPAR2)#; 

EQUATE DIT' TIMER = 58; 

DEFINE TIMER 'REQUEST 'LIST 'NUMBER = 
PAD'DIT'ARRAY(DIT'TIMER)#; 

<<This word holds the value of the timer request list >> 
<<entry returned from the procedure TIMERREQ. It is » 
<<stored here so that the timer request can be aborted>> 
<<using this value as a reference. >> 

EQUATE DSTOP = 59; 

DEFINE SS' BREAK 'CHARACTER = PAD 'DIT 'ARRAY (DSTOP) . (0:8)#; 

<<This byte is the character used as a subsystem break>> 
« character by the completor. Default is control Y >> 
«which is ASCII EM. This is set by an IOQ with a » 
<<function code 37- >> 

DEFINE EOR'CHARACTER = PAD 'DIT 'ARRAY (DSTOP) . (8:8)#; 

<<This byte is the character used as the end-of-record>> 
<<character for use by the completor. It is set by >> 
«an IOQ with function code 37. >:> 

<<Default is Carriage Return in character mode and >> 
<<Record Separator in block mode 

EQUATE CARRIAGE 'RETURN = 13 
EQUATE RECORD 'SEPARATOR = 30 
EQUATE CONTROL 'Y = 25 

EQUATE STORE' READ 'DST = 60; 

DEFINE BUFFERED 'READ 'DST = PAD 'BIT' ARRAY ( STORE 'READ'DST)#; 

<<This contains the DST # of a temporary extra data 
<<segment used to temporarily buffer incoming data 
<<that was not expected, e.g., logon hello requests, 
«data held when EOF found. 



EQUATE STORE 'READ 'OFF = 6l; 

DEFINE BUFFERED 'READ 'OFFSET = PAD'DIT'ARRAY(STORE'READ'OFF)#; 

<<This holds the offset in the extra data segment for>> 
<<buffered read data. >> 



EQUATE STORE 'READ'B'C = 62; 

DEFINE BUFFERED 'READ 'BYTE 'COUNT = PAD 'DIT 'ARRAY (STORE 'RE AD' B'C)#; 
<<This holds the positive byte count of the number >> 
<<characters stored in the temporary read buffer. >> 



>> 
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ft************************************************************* 
* PAD TERMINAL EXTRA DATA SEGMENT * 



The PAD terminal extra data segment is a buffer for storing both 
write and read data as well as carriage control characters. This 
extra data segment is acquired at logon time and is released when 
the terminal logs off. It is never frozen in memory. 

Its areas include: 

(1) Five words giving the segment relative offsets to 
tables and buffers. The offsets are byte offsets. 
Note that at the present time, the parity conversion 
tables are not used. These offsets are used only 
for parity conversion, but not implemented now. 

(2) A table of carriage control characters to be sent with 
the user write data. 

(3) Two areas for parity conversion tables, unused at 
the present time. 



(U) The initial PAD parameters set for the terminal user 
when he logs on to the host. 

(5) The values of the PAD parameters that are to be set 

by this driver, sent as a SET or SET AND READ PAD command. 

(6) The area in which to read in the values of the PAD 
parameters following a SET AND READ level-1 data 
message to the PAD. 

(7) Two write buffers, each of length defined below. 

(8) The buffer area for level-0 reads, of length defined 
below. 

This buffer area is expandable 
when larger reads are needed. The maximum size 
allowable for the entire extra data segment (XDS) 
is 31232 words. 
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PAD TERMINAL DIT EXTENSION IN EXTRA DATA SEGMENT 



1 2 3 ^ 5 6 7 10 11 12 13 lU 15 16 17% 









Byte offset of even incoming parity 


conv. 


tab. 


Byte offset of even outgoing partiy 


conv. 


tab. 


Byte offset of write buffer 


Byte offset of write buffer 1 


Byte offset of read buffer 


Formfeed = %lk | Null 



Formfeed | Carriage Return = %15 
Carriage Return | Line feed = 5tl2 
Line feed | Line feed 



1 
2 
3 
1+ 

5 
6 

7 
8 



(total of 31 words of 2 line feeds) 

I I o 

! Line feed ! Line feed ! 3° 

| | 

j Exclamation Points | Exclamation Point = ! I 39 



j Exclamation Point! | Carriage Return = %15 

I 

| Line feed = %12 | 



(Unused now) 



j (128 words) 
V 



| (06U words) 
V 



j Table to convert incoming even parity to \ k2 



j Table to convert outgoing data to parity 
(Unused now) 



170 



| 0| 
I 



MC 



| Parm # = 1 



| Parm 1 initial value | Parm # = 2 

I 

| Parm 2 initial value | Parm # = 3 

i 



23U 
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Parm 12 initial value 



I 0| MC 

I 

SET value for parm. a 



I 



SET value for parm. b 



I 



I SET value for parm. n 

I 

I 0| MC 

I 

| READ area for parm. a 
I - 

I READ area for parm. b 



I READ area for parm. n 



Null 
Parmeter# a 
Parmeter # b 
Parmeter # c 



2k6 



Null 
Parmeter # a 
Parmeter # b 
Parmeter # c 



I 258 



Null 



I 



I 272 
LEVEL -0 WRITE BUFFER | 

| Length can be 
| changed by a new 
V equate of 

LENGTH ' READ 'WRITE ' BUFFERS 



LEVEL -0 WRITE BUFFER 1 



1232 



I Length = 

V LENGTH 'READ' WRITE 'BUFFERS 



LEVEL -0 READ BUFFER 



I 



2192 



I Initial length = 

V LENGTH'READ' WRITE 'BUFFERS 



3152 (initially) 
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The MC is the message code. For a description 
of this and the PAD parameters and their values, see 
CCITT X.3 and X.29 specifications. 



#0 
1 
2 
3 
U 

5 
6 

7 
8 

9 
10 



<<End of Comment >>; 



IODS0 IOQ 



1 2 3 ** 5 6 7 8 9 10 11 12 13 lfc 15 
ABjSPjB jBCjIOlBLiCOjCFlCIl ' jFF|HA|S0|STiD0i 



NEXT IOQP 



MULTI-PACK HEAD+APP LN | LDEV 
HEADER ADDRESS (DSDS REL) 



REQUESTING DST NUMBER 
XMIT ADDRESS (DSDS REL) 



DSDST | FUNC CODE 

XMIT COUNT (+W0RDS/ -BYTES) 



RECEIVE ADDRESS (REQUESTING DS REL) 
RECEIVE COUNT 
PCBN | ERROR CODE 



.QFLAG 
.QLINK 
.QLDEV 
.QMISC 
.QDSTN 
.QADDR 
.QFUNC 
•QWBCT 
.QPAR1 
.QPAR2 
.QSTAT 



21-37 



IODSO IOQ NOTES 



•QFLAG 



AB - Abort request and return error to caller. 

SP - :DSCONTROL operator request from CONSDSLINE'. 

B - Broken. 

BC - Sense of request is in bytes. 

10 - Wake caller on completion of request. 

BL - Blocked I/O. Wait in attachio until completion. 

CO - Request is completed and caller waken if requested. 

CF - Continuation record flag (are processing cont reeds) 

CI - Continuator record initiator IOQ. 

PF - IOQ aborted because of power failure. 

HA - Hard Pre-empt. This is a DSMON request. 

SO - Soft Pre-empt. This is a non -DSMON request. 

ST - Request started. 

DO - DSMON request is complete. (Two part requests only) 

.QLINK - SYSDB relative pointer to first word of next IOQ. 
.QLDEV - Logical Device number. 

•QMISC - If DSMON request, then DSLCB address. (DSMON DST 
relative) Else, the offset in DS data segment of 
the header address. 
.QDSTN - Contains the DST number of the target data area. 
.QADDR - Transmit address. 
.QFUNC 

DSDST - DS DST number in AFT(l) for non-DSMON requests. 

Set to zero for DSMON requests. 
FUNC - = Reserved for DSWRITECONV. 

1 = DSWRITE. 

2 = DSOPEN. 

3 = DSCONTROL. 
U = DSCLOSE. 

5 = DSWRITECONV. 

.QWBCT - Transmit count. 

.QPAR1 - Receive address. (DSWRITECONV only) 

.QPAR2 - Receive count. (DSWRITECONV only) 

.QSTAT - Request completion status and PCB number which is 
associated with this request. 

.QPCBN - PCB number associated with this request. 

If zero, this IOQ element will be returned by the 
system when the request is completed. 
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DS DEVICE (IODSO) ATTACHIO CALLS 



QMISC 


DSTX 


ADDR FUNC 


rriTTwrp 

\*> v *-**i -J. 


D-l 


P2 I 


i-LAC-S 


BREAK 
(DSBREAE) 














Break 
Type 


Pin 


%203 


REJECT 
(DSREJECT) 














Reject 
Stuff 


From/To 
Process 


%203 


WRITE Header 
(DSWRITE) 


Data 
DST 


Output 
Buffer 


1 


Output 
Length 








DSparm 


OPEN 
(DSOPEN) 


Stack 
DST 


Info 
Buffer 


2 


Info 
Length 


DSoptions 


%201 


CLOSE 
(DSCLOSE) 


Stack 
DST 


Dummy 
Buffer 


3 





Close 
Type 





%201 


CONSREQ 
(CONDSLINE') 


Stack 
DST 


as below 


U 




as below 




%2Ul 




TRACEON 




TraceFile 
Name 




TraceFile 
Name Length 


Trace 
Options 




TRACEOFF 




Dummy 
Buffer 







1 







OPEN/SHUT 




LineSpeed 
(double) 




2 


3 


Open 
Options 




MON 




Dummy 
Buffer 







7 


Monitor 
Options 




DEBUG 




Dummy 
Buffer 







8 


Debug 
Options 




RETRIES 




RetryCount 
( integer) 




1 


9 







WRITECONV Headei 


• Data 
DST 


Output 
Buffer 


5 


Output 
Length 


Input 
Buffer 


Input 
Length 


DSparm 


WRITECONV LCB 
(DSMON) 


DSMON 
Stack 


BUF2 
(output) 


5 


Output 
Length 


BUF1 
(input) 


Input 
Length 
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DS DEVICE (IODSO) ATTACHIO CALLS 

RETURN := ATTACHIO( LDEV, QMISC, DSTX, ADDR, FUNC, COUNT, PI, P2, FLAGS) 

LDEV - logical device number of DS device 

QMISC - miscellaneous request -dependent parameter 
HEADER - address of DSCB header area in device-process DS XDS 
LCB - address of Line Control Block in DSMON's stack 

RTE TIMESTAMP - 111 

DSTX - DST number for data segment containing ADDR buffer 
Data DST - DST number for stack or extra data segment with data 
Stack DST - DST number for stack (of course) 

ADDR - address of data or other request information (in DSTX) 
Output Buffer - address of buffer holding outgoing data 
Info Buffer - address of buffer holding open info (see OPEN MON REQ) 
BUF2 - address of DSMON's BUF2, holding incoming messages 
Trace file name - character string name of trace file (optional) 
Line Speed - double value for CS line speed 
Retry Count - integer value for CS error retry count 
Dummy Buffer - address not used by request 

FUNC - function code identifying request 

COUNT - length of data in ADDR buffer 
Output Length - length of data in Output Buffer (+words/-bytes) 
Info Length - length of data in Info Buffer (+words) 
Trace File Length - length of Trace File Name (+words) 

PI - request -dependent parameter 

Break Type - ??? 

Reject Stuff - ??? 

DS Options - master/slave enabled (see OPEN MON REQ) 

Close Type - if bit Ik = 1 then final close else not final close 

Input Buffer - address of buffer to holding incoming data 

BUF1 - address of DSMON's BUF1, to hold outgoing messages 

Request Type - code selecting type of CONSREQ 

P2 - request -dependent parameter 

Pin - ??? 

From/to process - ??? 

Input Length - length of Input Buffer (+words/-bytes??) 

Trace Options - see TRACE DSMON REQUEST 

Open Options - see OPEN/SHUT DSMON REQUEST 

Monitor Options - see MON DSMON REQUEST 

Debug Options - see DEBUG DSMON REQUEST 

FLAGS - flags specifying wait/no wait 10, preemption, etc. 
%200 - Soft preempt, no wait (slave PTOP DSWRITECONV) 
%201 - Soft preempt, wait (other user DSWRITECONVs ) 

%203 - Soft preempt, nowait, no PCB (DSREJECT and DSBREAK) 
Jt2>+1 - Soft preempt, wait, special (CONSREQ) 
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%Uoo 
jiUoi 

DSparm 



- Hard preempt, no wait 

- Hard preempt, wait 

- J1200, %201, ?iU00, or %U01 



(DSMON DSWRITECONV) 
(DSMON DSWRITECONV) 



DS DEVICE (IODSO) ATTACHIO RETURN VALUES 

Word 1 Word 2 

(0:8) (8:8) 

REJECT 1 1 III II till II I III llllll II 1 1 llllllllllllllllllllllin 

BREAK | main pin \l 1 1 1 1 1 1 1 1 1 1 l\l 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1\ 

+ + + + 

DSWRITE - nowait | IOQ index \l 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1\ 

+ + + + 

DSWRITE - wait \ III I II III 1 1 1\ comp code \l 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1\ 

+ + + + 

OPEN \l 1 1 1 1 1 1 1 1 1 1 1\ comp code | actual buffer size ! 

+ + + + 

CLOSE \ III llllll lll\ comp code \l 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1\ 

+ _+ + + 

CONSOLE REQ - all I //////////// 1 comp code \l 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1\ 

+ + + + 

DSWRITECONV - nowait | IOQ index Mill llllll III I llllll llll\ 

+ + + + 

DSWRITECONV - wait I ////////////I comp code | received data length | 

+ + + + 



Word 1: 

main pin 
comp cods 



IOQ index 



apparently not used in DSBREAK?? 
completion code: 

= 10 request not yet completed 

1 = 10 request successfully completed 
> 1 = 10 request failed; CS error code 

pointer to IOQ for nowait 10 request 



Word 2: 

actual buffer size - actual size of DSMON buffer 

received data length - actual length of data moved into INBUF 
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# o 
1 

2 
3 
U 

5 
6 
7 
8 

9 

10 



IODSX IOQ 
1 2 3 U 5 6 7 8 9 10 11 12 13 ll» 15 

==l==l==l==l==l==l==l==l==l==l==l==l==l==l==l== 

AB|SP| | |IO|BL|CO| |RE| | | |HA|SO|ST|DO 
NEXT IOQP 
| LDEV 

DSDST | FUNC CODE 

PCBN | ERROR CODE 

==l==l==l==l==l==l==l==l==l==l==l==l==l==l==l== 
1 2 3 U 5 6 7 8 9 10 11 12 13 l*+ 15 



ft QFLAG 

1 QLINK 

2 QLDEV 

3 QMISC 
U QDSTN 

5 QADDR 

6 QFUNC 

7 QWBCT 
10 QPAR1 
U QPAR2 
12 QSTAT 
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IODSX IOQ NOTES 



• QFLAG 



AB - ABORT REQUEST AND RETURN ERROR TO CALLER 

SP - :DSCONTROL OPERATOR REQUEST FROM CONDSLINE' 

10 - WAKE CALLER ON COMPLETION OF REQUEST 

BL - BLOCKED I/O. WAIT IN ATTACHIO UNTIL COMPLETION 

CO - REQUEST IS COMPLETED AND CALLER WAKEN IF REQUESTED 

RE - RESET REQUEST ISSUED TO DSMONX. 

HA - HARD PRE-EMPT. THIS IS A DSMONX REQUEST. 

SO - SOFT PRE-EMPT. THIS IS A NON DSMONX REQUEST. 

ST - REQUEST STARTED. 

DO - MESSAGE DONE. 

.QLINK 

SYSDB RELATIVE POINTER TO FIRST WORD OF NEXT IOQ. 
.QLDEV 

LOGICAL DEVICE NUMBER OF DSDEVICE. 
.QMISC 

MISCELLANEOUS REQUEST-DEPENDENT PARAMETER: 
.QDSTN 

DST NUMBER FOR DATA SEQMENT CONTAINING ADDR BUFFER 
.QADDR 

ADDRESS OF DATA OR OTHER REQUEST INFORMATION IN DSTN 
.QFUNC 



DSDST - DS DST 


NUMBER IN AFT(l) F( 


FUNC - FUNCTION CODE IDENTIFYING 


FUNC 


DSBREAK 




DSREJECT 


FUNC 1 


DSWRITE 


FUNC 2 


DSOPEN 


FUNC 3 


DSCLOSE 


FUNC U 


DSCONSREQ 


FUNC 5 


DSWRITECONV 


FUNC 6 


ABORT READ 


FUNC 7 


INCOMING REPLY 


FUNC 8 


TIMER 


FUNC 9 


ABORT TIMER 


FUNC 10 


RESET 


FUNC 11 


FLOW CONTROL 


FUNC 12 


PAD CLEAR REQUEST 
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.QWBCT 

LENGTH OF DATA IN ADDR BUFFER 

.QPAR1 
.QPAR2 

REQUEST DEPENDENT PARAMETERS 

.QSTAT 

REQUEST COMPLETION STATUS AND PCB NUMBER WHICH IS 

ASSOCIATED WITH THIS REQUEST. 

PCBN - PCBN ASSOCIATED WITH THIS REQUEST. IF ZERO, 
THIS IOQ ELEMENT WILL BE RETURNED BY THE 
SYSTEM WHEN THE REQUEST IS COMPLETED. 
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DS DEVICE 
QMISC DSTN 

BREAK 

(DSBREAK) 
REJECT RTE TIME 

(DSREJECT) 

WRITE Header Data 
(DSWRITE) DST 

OPEN Stack 
(DSOPEN) DST 

CLOSE UC NUM. Stack 
(DSCLOSE) DST 

CONSREQ Stack 
(CONDSLINE') DST 

TRACEON 

TRACEOFF 

OPEN/SHUT 



(IODSX) ATTACHIO CALLS 
ADDR FUNC COUNT PI 



DEBUG 



WRITE Header Data 
CONV DST 

ABORT Termianl 
READ DIT PTR 

INCOMING Request 
REPLY Code 

TIMER Time 
Requested 



P2 








Output 
Buffer 

Info 
Buffer 

Dummy 
Buffer 








FLAGS 
%203 



Break Pin 
Type 
UC Reject From/To %203 
number Stuff process 



Output 
length 

Info DSoptions 
Length 

Close 
Type 



as below h as below 



DSpam 
%201 
%201 
- %2Ul 



Trace file Trace file Trace 

Name Name Length Option 

Dummy 10 

Buffer 



LineSpeed 
(double) 

Dummy 
Buffer 

Output 
Buffer 



5 
6 

7 
8 



3 
8 



Open 
Options 

Debug 
Options 



Output Input Input DSparm 
Length Buffer Length 

UC MainPin %203 
Number 



UC 

Number 



%203 
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ABORT 
TIMER 



RESET 



10 



UC MainPin %203 
Number 



FLOW 
CONTROL 



11 



UC From/To %203 
Number Process 



PAD 

CLEAR 



12 



UC 
Number 



%203 
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DS DEVICE (IODSX) ATTACHIO CALLS (NOTES) 

RETURN : = ATTACHIO( LDEV s qMISC 5 DSTN s ADDR 5 FUNC s COUNT-Pl-P2 s FLAGS) 

LDEV - logical device number of DS device. 

QMISC 

RTE Time - RTE time stamp used by 1000 systems. 
HEADER - Address of DSCB header area in device-process 
DS XDS. The DST number for this XDS is given 
in DSDST field of QFUNC. 
UC Num - UC number associated with the close request. 
Terminal DITP - Terminal DIT pointer. 
Request Code - Request code associated with incoming request. 

(Clear or Reset) 
Time Requested- Time requested by DSMONX for Timer request. 



DSTN 

Data DST 
Stack DST 



- DST number for stack or extra data data seqment. 

- DST number for stack. 



ADDR 



Address of data or other request information in DSTN. 



Output Buffer - 
Info Buffer 

Dummy Buffer - 
Line Speed 
TraceFile name- 



Address of buffer holding outging data. 

Address of buffer holding call information to 

be used by DSMONX or passed to high levels. 

Address not used by request. 

Double value for CS line speed. 

Character string name of trace file (optional), 



FUNC 



- Function code identifying request. 



COUNT - Length of data in ADDR buffer. 

Output length - Length of data in Output buffer (+words/ -bytes) 
Info length - Length of data in Info buffer ( +words/ -bytes ) . 
Trace File Len.- Length of trace file name (+words). 



PI 



Request-dependent parameter. 



Break Type 



Reject Stuff 



DSoptions 

Close Type 
Input Buffer 
Console code 



Break 
Control Y 
Resume 
Abort 



= -1 
= 
= 1 
= 2 



This word contains the following: 



( 0: 
( U: 

(10: 



6) 
6) 



= R.E.C.B 

= Message Class 

= Stream Type 
Master/Slave enabled. If bit 10=1 then slave 
first DSOPEN. 

If bit ll+=l the final close else not final close. 
Address of buffer holding incoming data. 
Code selecting type of CONSREQ. 
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P2 - Request-dependent parameter 
Pin - Current Pin. 

From/To process- From and To process number. 
Input Length - Length of input buffer (+words/-bytes) . 
Trace Options - see Trace DSMON REQUEST. 
Open Options - see OPEN/SHUT DSMON REQUEST. 
Debug Options - see DEBUG DSMON REQUEST. 
MainPin - Mainpin associated with this request. 

FLAGS - Flags specifying wait/no wait 10, preemption, etc. 
%200 -Soft preempt, no wait (slave PTOP DSWRITECONV) 

%201 -Soft preempt, wait (other user DSWRITECONV) 

%203 -Soft preempt.no wait, no PCB 

%2Ul -Soft preempt, wait, special (CONSREQ) 

DSPARM - %200, %201 
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DS DEVICE (IODSX) ATTACHIO RETURN VALUES 



WORD 1 
(0:8) (8:8) 



WORD 2 



REJECT 

BREAK 

DSWRITE - no wait 

DSWRITE - wait 

OPEN 

CLOSE 

CONSOLE REQ - ALL 

DSWITECONV - wait 

ABORT READ 

INCOMING REPLY 

TIMER REQUEST 

ABORT TIMER REQ 

RESET 

FLOW CONTROL 

PAD CLEAR 



I //////// I 1 
I //////// I 1 
! IOQ INDEX 
i llllllll I COMPCODE 
I //////// I COMPCODE 
i mif/ll 1 COMPCODE 
I llllllll I COMPCODE 
I III llll 1 1 COMPCODE 
1 
1 
1 
1 
1 
1 



Mil llll I 
\ llllllll 

Milium 
Milium 
Milium 
Milium 
Milium i 



i m u ilium i m i 
i ///////////////// 1 
i miuiiuu m ii i 
i milium mi ii i 

| UC NUMBER | 
i /////////////////! 

i mil i inn nun i 

I received data ln| 
I ///////////////// I 
I III llllllll 1 11 III I 
I ///////////////// I 

i minimum ii i 
i ///////////////// i 
i ///////////////// i 
Mmuimuium 



WORD 1: 

COMPCODE - Completion code: 

= 10 request not yet completed. 

1 = 10 request successfully completed. 
>1 = 10 request failed, CS error code 

IOQ INDEX - Pointer to IOQ for nowait 10 request 



WORD 2: 

Received data In 



Acctual length of data moved into INBUF 
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IODSTRMO IOQ 
1 2 3 h 5 6 7 8 9 10 11 12 13 1*4 15 



#0 
1 
2 
3 
U 

5 
6 

7 
8 



n 
7 



10 



==l==l==l==l==l==l==l==l==l==l==l==l==l==l==l== 

AB|CI|XR|BC|lO|BL|CO|CR|CF|MO| |HA|SO|ST|DO 


NEXT IOQP 




UNIT NUMBER 


| LDEV 


RESERVED FOR FUTURE USE (SET TO ZERO) 


D 


DAW 


i SEGMENT NUMBER 




TARGE! 


' ADDRESS OFFSET 




UNUSED 


| FUNCTION CODE 




COUNT 


(+WORDS/ -BYTES) 




PARAMETER 


1 (FUNCTION DEPENDENT) 




PARAMETER 


2 (FUNCTION DEPENDENT) 




PCBN 


| QUAL STAT | GEN STAT 



.QFLAG 
.QLINK 
.QLDEV 

.QDSTN 
.QADDR 
.QFUNC 
.QWBCT 
.QPAR1 
.QPAR2 
.QSTAT 
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IODSTRMO IOQ NOTES 



.QFLAG 



AB - Abort request and return error to caller, 

CI - Currently in CI prompt /read sequence. 

XR - Print "buffer expansion requested. 

BC - Request is in bytes. 

10 - Wake caller on completion of request. 

BL - Blocked I/O. Wait in attachio until completion. 

CO - Request is completed and caller waken if requested. 

CF - Continuation record flag (are processing cont reeds) 

CI - Continuation record initiator IOQ. 

MO - IOQ modified by driver 

HA - Hard Pre-empt. This is a DSMON request. 

SO - Soft Pre-empt. This is a non-DSMON request. 

ST - Request started. 

DO - DSMON request is complete. (Two part requests only) 



.QLINK 
.QLDEV 
.UNIT 
.QDSTN 
D 

.QADDR 
.QFUNC 
.QWBCT 
.QPAR1 
.QPAR2 
• QSTAT 

.QPCBN 



.QUAL 
.GEN 



Parameter one 
Parameter two 



SYSDB relative pointer to first word of next IOQ. 

Logical Device number. 

Logical unit number. 

Contains the DST number of the target data area. 

1 = DB relative offset. 

= Segment relative offset. 

Offset to the target area data segment. 

Function code field. 

Word count or byte count and control returns. 
(Function dependent use) 
(Function dependent use) 

Request completion status and PCB number which is 

associated with this request. 

PCB number associated with this request. 

If zero, this IOQ element will be returned by the 

system when the request is completed. 

A code that further defines the general status. 

General status. Indicates the current status 

according to the following codes: 

= Not started or awaiting completion. 

1 = Successfully completed. 

2 = End of file detected. 

3 = Unusual conditon encountered. 

k = Irrecoverable error encountered. 
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# o 
1 

2 
3 

It 

5 
6 

7 
8 

9 

10 



IODSTRMX IOQ 

1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 

AB|CI| | |I0|BL|C0| | RE | MO | | |HA|SO|ST|DO 

NEXT IOQP 

UNIT NUMBER | LDEV 

RESERVED FOR FUTURE USE ( SET TO ZERO ) 

DATA SEGMENT NUMBER 

TARGET ADDRESS OFFSET 

UNUSED | FUNC CODE 

COUNT (+WORDS/-BYTES) 

PARAMETER 1 (FUNCTION DEPENDENT) 

PARAMETER 2 (FUNCTION DEPENDENT) 

PCBN | QUAL STAT | GEN STAT 

==l==l==l==l==l==l==l==l==l==l==l==l==l==l==l== 
1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 



% QFLAG 

1 QLINK 

2 QLDEV 

3 QMISC 
U QDSTN 

5 QADDR 

6 OJFUNC 

7 QWBCT 

10 QPAR1 

11 QPAR2 

12 QSTAT 
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IODSTRMX IOQ NOTES 



•QFLAG 

AB - ABORT REQUEST AND RETURN ERROR TO CALLER. 

CI - CURRENTLY IN CI PROMPT/READ SEQUENCE. 

10 - WAKE CALLER ON COMPLETION OF REQUEST. 

BL - BLOCKED I/O. WAIT IN ATTACHIO UNTIL COMPLETION. 

CO - REQUEST IS COMPLETED AND CALLER WAKEN IF REQUESTED. 

RE - RESET REQUEST ISSUED TO DSMONX. 

MO - IOQ MODIFIED BY DRIVER. 

HA - HARD PRE-EMPT. 

SO - SOFT PRE-EMTP. 

ST - REQUEST STARTED. 

DO - MESSAGE DONE. 

.QLINK - SYSDB RELATIVE POINTER TO FIRST WORD OF NEXT IOQ. 

.QLDEV - LOGICAL DEVICE NUMBER. 

.UNIT - LOGICAL UNIT NUMBER. 

.QDSTN - CONTAINS THE DST NUMBER OF THE TARGET DATA AREA. 

.QADDR - OFFSET TO THE TARGET AREA IN DATA SEGMENT. 

.QFUNC - FUNCTION CODE FIELD. 



0. READ %20. 

1. WRITE %21. 

2. FILE OPEN 22. 

3. FILE CLOSE 23- 
k. DEVICE CLOSE 2k. 

5. SET TIMEOUT 25. 

6. SET INSPEED 26. 

7. SET OUTSPEED 27. 
%1Q. ECHO ON 30. 

11. ECHO OFF 31. 

12. DISABLE BREAK 32. 

13. ENABLE BREAK 33- 
lU. DISABLE ESCAPE 3 1 *. 

15. ENABLE ESCAPE 35- 

16. DISABLE TAPEMODE 36. 

17. ENABLE TAPEMODE 37- 



DISABLE TIMER 

ENABLE TIMER 

READ TIMER 

DIABLE PARITY 

ENABLE PARITY 

LOGGED ON 

SET PARITY 

SET TERMINAL TYPE 

ALLOCATE TERMINAL 

CLEAR FLUSH AND WRITE 

ENABLE CONTROL X ! ! ! ECHO 

DISABLE CONTROL X ! ! I ECHO 

NOT USED 

PTAPE READ 

SET/RESET BREAK MODE 

SET/RESET CONSOLE MODE 



.QWBCT - WORD OR BYTE COUNT AND CONTROL RETURNS. 

.PCBN - PCB NUMBER ASSOCIATED WITH THIS REQUST. IF ZERO THIS 

IOQ ELEMENT IS RETURNED BY THE SYSTEM WHEN THE 

REQUEST IS COMPLETED. 
.QUAL - A CODE WHICH FURTHER DEFINES OR QUALIFIES THE GENERAL 

STATUS. 
.STATUS - GENERAL STATUS. INDICATE THE CURRENT OR RESULTANT 

STATUS OF THE REQUEST ACCORDING TO THE FOLLOWING 

CODES : 

- NOT STARTED OR AWAITING COMPLETION. 

1 - SUCCESSFULLY COMPLETED. 

2 - END OF FILE DETECTED. 

3 - UNUSUAL CONDITION. 

h - IRRECOVERABLE ERROR. 
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1 

2 
3 
k 
5 
6 

7 
8 

9 
10 



IOPADO IOQ 
1 2 3 U 5 6 7 8 9 10 11 12 13 l 1 * 15 

AB| | 10 | BL | CO | |HP|SP|ST|DN 

POINTER TO NEXT IOQ POINTER 
UNIT NUMBER | LDEV 
FL| |READSTOP| RSTATE 

ST | DATA SEGMENT NUMBER 
TARGET ADDRESS OFFSET 
UNUSED | FUNCTION CODE 

DATA COUNT (+W0RDS/- BYTES) 
PARAMETER 1 (FUNCTION DEPENDENT) 

PARAMETER 2 (FUNCTION DEPENDENT) 
PCBN | QUAL STAT | GEN STAT 



.QFLAG 
.QLINK 
.QLDEV 

.QDSTN 
.QADDR 
•QFUNC 
.QWBCT 
.QPAR1 
.QPAR2 
.QSTAT 
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IOPADO IOQ ELEMENT FIELD NAMES 



EQUATE QFLAG 



= 0; <<Flags field of IOQ element >> 



<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 



Flags and Request State Information 

Bit 0:1 ABORTED bit. When set, abort this 

request and return an error condition 
to the caller. 

Bits 1:3 Unused. 

Bit U:l 

Bit 5:1 



Wake caller on completion of request. 



Blocked I/O. The caller is waited in 
ATTACHIO until request is completed. 
Implies wake. 



Bit 6:1 

Bit 7=5 
Bit 12:1 
Bit 13:1 
Bit lU:l 
Bit 15:1 



>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 



Completed. The request has been 
completed and callwaking caller is requested>> 

>> 

Unused. >> 

>> 



ABORTED 

WAKE 

BLOCKED 

COMPLETED 

PRE' EMPT' LEVEL = 

SOFT' PRE' EMPT = 

HARD'PRE'EMPT = 

STARTED = 

MSG'DONE 

STARTED 'MSGDONE 

QLINK 

QLDEV 



QMISC 
QDSTN 



Hard pre-empt write request. 

Soft pre-empt write request. 

This request has been started. 

This request is done. Used for 2-step 
request operations. 

(0:1) 

(b:l> 

(5:1) 

(6:1) 
(12:2) 
(12:1) 
(13:1) 
(1U:1) 
(15:1) 
(lU:2) 



>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 



>> 
>> 



QADDR 



1; <<Po inter to next IOQ element 
<<on PAD terminal DIT if <> 

2; <<The left byte is the logical >> 
<<unit number, the right byte >> 
<<byte is the logical device >> 
<<number. >> 

3; <<Unused, =0 >> 

U; <<The source DST# (if outgoing) >> 
<<or target DST# (if incoming) >> 
<<of data to be transferred >> 

R r <<The sqiiti">o nffgoi-. /if >> 



21-55 



QFUNC 



<< outgoing) or target offset >> 
<<(if incoming) of data to be >> 
<< transferred >> 

<<The first bit, ST, is set to >> 

<<1 if the address is DB >> 

<<relative; it is if it is >> 

<< segment relative. >> 

6; <<The right byte of this word >> 
<<is the f miction code: 
<< 

: read 

1: write 

2: file open 

3: file close 

U: device close 

5: set read timeout 

6: set input speed 

7: set output speed 

8 : enable echo 

9: disable echo 

disable break 

enable break 

disable subsystem break>> 

enable subsystem break >> 



<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 



« 10 

<< 11 

<< 12 

<< 13 

<< lit 

<< 15 

<< 16 

« 17 

<< 18 

<< 19 

« 20 

<< 21 

« 22 

<< 23 

« 2U 

<< 25 

« 26 

<< 27 

<< 28 

« 29 

« 30 

<< 31 

<< 32 

« 33 

« 3U 

« 35 

<< 36 

« 37 
<< 



>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 



disable tape mode 
enable tape mode 
disable read timer 
enable read timer 
return timed read 
disable parity check 
enable parity check 
set logon type 
unused 

set terminal type 
allocate terminal 
clear flush & write 
ctrl X echo on 
Ctrl X echo off 
unused 
ptape read 
set break mode 
set console mode 
set parity 
allocate terminal 
set terminal type 
return terminal type 
return terminal speed 
set new stop and 
subsystem break chars. 



>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 



21-56 



QWBCT 
QPAR1 
QPAR2 



= 7; <,c The + word or - byte count of>> 
<<the data to be transferred >> 

=JllO; <<The first parameter, function>> 

<< dependent; see table below. >> 

= Jill; <<The second parameter, function>> 

<<dependent; see table below. >> 



QSTAT 



= Jll2; <<The status of the IOQ request >> 
<<the left byte is the process >> 
<< control block number (if it >> 
<<is zero, this IOQ element is >> 
<< returned by the system when >> 
<<l/0 is complete, the right >> 
<<byte contains status >> 
<<status information >> 



IOQ'PCBN = (0:7) 



<<PCB number associated with this >> 
<<request. If zero, this IOQ >> 
<<element is returned by the system>> 
<<when the request is complete. It >> 
<<will be zero if driver does an >> 
«ATTACHIO itself. » 



IQQ'QUALIFIER = (8:U) ; <<Qualifying status, see >> 

<<ATTACHIO for details. >> 

IOQ'STATUS = (12: U) ; <<General status of the request: >> 



<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 
<< 



Not started 

Sucessfully completed; 
End-of-file detected; 
Unusual condition; 
Irrecoverable error; 



>> 
>> 
» 
>> 
>> 
>> 



>> 
>> 
>> 



This request, presumably a 
print is to be sent as soon 
as there is a GETQ available ;>> 
used for pre-emptive prints. >> 
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IOPADO IOQ PARAMETERS 1 AND 2 AND IOQ FUNCTIONS 



IOQ FUNCTION 
: Read 



MEANING OF QPAR1 AND QPAR2 

PI. (0:1) 1: Suppress line feed following read. 

PI. (13:3) 

0: reset EOF and read 

1: detect :EOF: 

2: detect all data EOF's 

3: detect all session EOF's 

h: detect all job EOF's 

5: no EOF check; don't return 
saved EOF data on this read. 



P2.(0:8) Special end-of-read character 

if not 0. 
P2.(9:l) V/3000 read if set. 
P2.(10:l) User block mode read if set. 
P2.(ll:2) Binary read. 



Write 



PI Vertical format specification 

#01 : Use first character of user data 
as vertical format specification. 

#53 : Carriage return only. 

#55 '• Triple space and carriage return. 

#60 : Double space. 

#6l : Formfeed. 

#200-277 : (n-#200) LF's then carriage return. 

#320 : No vertical formatting, 

others : carriage return and line feed. 

P2.(15:l) : If set, prespace vertical formatting 
characters, e.g. in Fortran. 



2: 


File open 


PI 


: Terminal type. 






P2 


: Terminal speed 


3: 


File close 


P1,P2 


: Unused. 


It: 


Device close 


P1,P2 


: Unused. 


5: 


Set read timeout 


PI 


: Read time out 



6: Set input speed P1,P2 
7: Set output speed P1,P2 
8: Enable echo P1,P2 



read timeout. 

: This function is done by PAD, not driver. 

: This function is done by PAD, not driver. 

: Unused. Old echo setting returned in 
returned byte count. 
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9: Disable echo 



10-20: 



P1,P2 



P1,P2 



21: Set logon type PI 

22: Unused. 

23: Set terminal type PI 

2k: Allocate terminal PI 

P2 

25: Clear flush and write 

26-29: 



Unused. Old echo setting returned in 
returned byte count. 

The parameters in these function requests 
are not used. 

data, break not enabled 

1 session, break enabled 

2 job, break not enabled. 



Terminal type. 

Terminal type. 

Line speed, (unused). 

Same parameters as write. 

No parameter values checked. 



30: Set break mode 



PI 



31: Set console mode, unused. 

32: Set parity, unused presently. 

33: Same as function 33- 

3U: Same as function 23. 

35: Return terminal type 

36: Return output speed 

37: Set new stop and subsystem 
break characters PI 

.(0:8) 
•(8:15) 



Odd, terminal in break; 
Even, terminal not in break. 



Terminal type returned in byte count, 
Return speed in CPS in byte count. 



if 0, disable special character; 
subsystem break character 
stop character 
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DS I/O TABLE LINKAGE 



+=========+ 



(2) 



(7) +■ 



CS Device 
DIT 




DS Device 
DIT 



+ 

I 
v 



[user request IOQ] 
(1) 






+- 

I 
v 



[DSMON request IOQ] 



Virtual 
Terminal DIT 



Virtual 
Terminal DIT 



+ 

I 
v 






[virtual terminal 
request IOQ] 
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Q-Relative values for drivers IODSO , IODSTRMO and 
procedures DSKILLALL, DSLOGON, DSXIO, and DSREJECT. 

n 1 J> -* li 5 6 7 8 o 10 11 1? 1^ lli 15 



| XLDEV (DSABORT ENTRY) 


Q-5 


| FLAGS 


Q-U 


I x 


Q-3 


| DELTA P 


Q-2 


| STATUS 


Q-l 


! DELTA Q 


Q 


| HEADER 


Q+l 


J DSINFO, DSDITP 


Q+2 


I DSIOQP, DSIOQPD 


Q+3 


| DSDST, DSLOC 


Q+U 


| DSADDR 


Q+5 


I DSLCB (DSDST REL) 


Q+6 


| DSBUFSZ, DSBUFSZD 


Q+7 


| DSCOUNT 


Q+8 


J DITP 


Q+9 


I IOQP 


Q+10 


! TOPROC 


Q+ll 


| MSGCLS 


Q+12 


| STKMXXf, BKKUUJJ {If HEADEK = -i; 


Q+13 


| MSGLEN 


Q+lU 
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DSMON <---> DSIOM 
PSEUDO HEADER/CONTROL BLOCK 








1 


2 


3 h 5 6 7 8 9 10 11 12 13 lU 15 







- 1 




1 


- 1 or DSMON REQ. NUMBER 


.REQ 


2 


ERROR CODE 


.ERRCOD 


3 


BUFFER SIZE 


.BUFSIZE 


1» 


UNUSED | N| Q| L|STATE| X| M| S 


.FLAGS 


5 







6 







7 








NOTES 

This pseudo-header may at times he seen in words 
8-15 (%10-Jll7) of the IODSO DIT. 

.REQ - If DSMON request number is still the same 
when returned from DSIOM, then the request 
was processed. If a -1 is returned, and 
if ERRCOD = 0, then request was discarded 
due to a CSWRITE in progress and DSIOM has 
to resubmit the request. If a -1 returned 
and ERRCOD <> 0, then a CSERROR occurred 
on this request, and ERRCOD contains the 
CSERROR code. 

.FLAGS - Same as in the IODSO DIT. (DIT0.(9:7)) 
N - DSMON has a null CWRITE outstanding 
Q - DSMON has a CREAD ENQ outstanding 
L - CS line is a secondary 
STATE - CS line state 

- unconnected 

1 - control 

2 - text 

X - exclusive mode enabled 
M - master mode enabled 
S - slave mode enabled 
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DSMON REQUEST FORMATS 



DSMCN requests are internal messages sent from a user to a DSMON 
process to request some service (opening or closing a CS line, 
turning on CS tracing, etc.) The request is sent and executed 
by the following mechanism: 

1. The user calls ATTACHIO to initiate an 10 request. (See DS 
DEVICE ATTACHIO PARAMETERS) 

2. ATTACHIO calls DSIOM, which calls the IODSO driver to execute 
the 10 request. 

3. IODSO calls DSMONREQ to transmit the request to DSMON. 

U. DSMONREQ formats a DSMON request message, and moves it to 
DSMON' s incoming message buffer BUF1. 

5. DSIOM completes a pending DSWRITECONV from DSMON. 

6. DSMON awakes and notices the DSMON request in its BUF1. It 
executes the appropriate MONxxx procedure based on the request 
type, then calls DSWRITECONV to return the results of the 
request in a DSMON-DSIOM communications block. 

7. DSWRITECONV calls ATTACHIO which calls DSIOM. 

8. DSIOM processes the DSMON-DSIOM communications block and 
notices that a DSMON request has been completed. It calls 
IODSO again to finish completion of the 10 request. 

9. IODSO does associated bookkeeping (incrementing usecounts, etc) 
sets the ATTACHIO status returns to reflect the success or 
failure of the request, and calls DSCOMPLETE to complete the 
pending 10 request. 

10. The user's ATTACHIO call completes, giving the user the status 
of its request. (See DS DEVICE ATTACHIO RETURNS). 
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DSMON REQUEST FORMATS 



The general format of a DSMON request is 



+==|==l==i==l==l 



- 1 



:-|--|--|"l»+ 



Request type 
Request parameter 



Request buffer 



-1 - identifies the message as a DSMON request 

Request type - selects specific request 
Request parameter - one word of request-specific information 
Request buffer - more request-specific information (may be 

omitted) 
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DSMON REQUEST FORMATS 

Request type - MONTRCON - turns on CS tracing 

111111 

0123 1 *567890123 1 45 

+=H=H«I==I==I«I«I"I«I=H«I==I==I==I==I==+ 
j - 1 ! 

I — " I 

i I o ! 

I - 1 

2 |AL|WR| MASK | ENTRIES | Trace Options 
| 1 

3 I I 

TRACE FILE NAME 
2+n | | 



Request type = 

Request parameter - Trace Options 



AL 



WR 



MASK 



(0:1) 
(1:1) 
(2:8) 



• 
1 

- 

1 

• 
>0 



= trace I/O errors only 

= trace all activity 

= no wrap on trace entries 

= wrap trace entries if table is full 

= use default trace mask 

= mask indicating driver actions to trace 



bit 
bit 
bit 
bit 
bit 
bit 
bit 
bit 



2 
3 
k 

c 

6 
7 
8 

9 



bit 10 



STN 

OPR and EDT 

RCT 

SCS, POL, 
STX 

3270 STN 
not used 
mainframe 



SEL 



ENTRIES (11:5) 



IC 



Request buffer 



■ = use driver default for max entries per record 
>0 = (max number of entries per record )/8 

Trace file name, a string of 2n ascii characters 
with one or two trailing blanks 
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DSMON REQUEST FORMATS 



Request type 1 - MONTRCOFF - turns off CS tracing 



111111 
0123U567890123U5 

+..|..|„|.H-HHH--I--I--I--I--I"I--I--I--+ 

- 1 




1 
2 

Request type - 1 
Request parameter - unused 
Request buffer - none 
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DSMON REQUEST FORMATS 



Request type 2 - MONOPEN - first open to DS device; causes DSMON 

to COPEN CS device 



111111 
0123U567890123U5 






1 - 1 


1 


1 2 


2 


I STDLIST LDEV (X.21) | |Q |SL|QU|NC|CO|CI |EX 


3 


1 BUFSIZE 


U 


1 IDLIST LENGTH (+BYTES) 


5 


total number of IDs | local ID length 




local ID 




remote ID length | 




remote ID 1 




• • • 




remote ID n length | 




remote ID n 




PHONELIST Length 




total phone numbers = 1| phone number 1 length j 







phone number 



DS options 
Open Info 
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Request type 



DSMON REQUEST FORMATS 



Request parameter 
Q ( 9:1) 



SL 
QU 
NC 
CO 
CI 
EX 



(10:1) 
(11:1) 
(12:1) 
(13:1) 
(1U:1) 
(15:1) 



DS (open) options 

X.21 queued flag 

first slave DSOPEN 

QUIET 

NOCOMP 

COMP 

open from DSLINE or REMOTE HELLO 

EXCLUSIVE mode 



Request buffer 
BUFSIZE 
IDLIST 

PHONELIST 



COPEN related parameters 

size of DS line buffer (from : DSLINE LINEBUF) 

local and remote IDs (from : DSLINE LOCID and REMID) 

IDLIST length = - configured default id sequences 

remote phone number (from : DSLINE PHNUM) 

PHONELIST length = - configured default phone list 
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DSMON REQUEST FORMATS 
Request type 3 - MOHCONSCMD - opens or shuts master and slave access 



111111 
0123 1 *567890123 s *5 

i - 1 I 

I — - -I 

1 I 3 I 

I 1 

2 | NETWORK ID (X.21) | |SL| X| H| S| Open options 

3 | LINE I 
| SPEED j 



Request type - 3 

Request parameter - Open options (from :DSCONTROL command) 

SL (12:1) - Dev is X.21 switched line 

X (13:1) - Dev is X.21 related 

M (lU:lj - MASTER mode enabled 

S (15:1) - SLAVE mode enabled 

Request buffer - Line speed (double word value, from :DSCONTROL) 

(Line speed = - use configured default) 
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DSMON REQUEST FORMAT 

Request type U - MONCLOSE - last DSCLOSE to DS device; causes DSMON 

to CCLOSE the CS line 



111111 
123 1 *567890123 1 *5 





1 



h-l--l«l«l-l«l„l»=l„l„l„l„l„l„l„l M+ 

- 1 
It 



Request type - k 
Request parameter - not used 
Request buffer - none 



NOTE: Request types 5 (MONSYSOPEN) and 6 (MONSYSREAD) no longer exist. 
They appear to have been a planned feature of DS that fell 
through the cracks and was lost and forgotten. Remains of this 
prehistoric code can be found in DSMON. 
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DSMON REQUEST FORMATS 
Request type 7 - MONMON - turns on (off) CS and DS MMSTAT monitoring 



111111 
OI23U56789OI23U5 

! - 1 ! 

I— -I 

1| 7 I 

I 1 

2 I ////////////////////////////////////// 1 CS I DS I ON I Monitor opt ions 



Request type - 7 

Request parameter - Monitor options 

CS (lU:l) - = doesn't effect CS monitoring 

1 = turn on (off) CS monitoring 
DS (15:1) - = doesn't effect DS monitoring 

1 = turn on (off) DS monitoring 
ON (15:1) - = turn off monitoring 

1 = turn on monitoring 

Request buffer - none 
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DSMON REQUEST FORMATS 



Request type 8 - MONDEBUG - activates or deactives DSMON breakpoints 



111111 
0123U567890123U5 
+ ==|= = |= = |==|==| = =| S =|= = |«|==| = =|==|„|„|„| ==+ 



DEBUG OPTION 



Request type 



8 



Request parameter 



Debug option 

= deactivate DSMON breakpoint 

1 = activate DSMON breakpoint 

2 = activate fatal error traps: 

if DS error, cause System Failure 915 
if CS error, cause System Failure 916 



Request buffer 



none 
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DSMON REQUEST FORMATS 



Request type 9 - MONRETRIES - changes number of CWRITE error retries 



111111 
0123U567890123U5 

01 '-i 



NUMBER OF RETRIES 



Request type - 9 

Request parameter - not used 

Request buffer - number of retries (single word value) 
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DSMONX Communication Buffers Format 
DSGETQ & DSPUTQ buffer format 



DSGETQ BUFFER 



# OF ENTRIES 


ENTRY 


1 


ENTRY 


2 




ENTRY 


N 



DSPUTQ BUFFER 



# OF ENTRIES 


ENTRY 


1 


ENTRY 


2 




ENTRY 


N 



USER CHANNEL NUMBER 


REQUEST/REPLY CODE 


IOQINDEX / ZERO 


T-DATA DESCRIPTOR 1 


R-DATA DESCRIPTOR 1 


T-DATA DESCRIPTOR 2 


R-DATA DESCRIPTOR 2 


T-DATA DESCRIPTOR 3 


R-DATA DESCRIPTOR 3 


MAINPIN 



ENTRY FORMAT 
+ +-- 



USER CHANNEL NUMBER 
IOQINDEX / ZERO 

R-DATA DESCRIPTOR 
REQUEST/REPLY CODE 

REQUEST STATUS 
CHAN. TYPE I MAINPIN 
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dsgetq' fc=%20, 

<< ATTACHIO function code for DSGETQ request >> 

dsgetq' entlen=22, 

<< each request entry size in DSGETQ buffer >> 

dsgetq ' buf len=dsgetq ' entlen*max ' num ' of ' entries+1 ; 

<< the buffer size for DSGETQ request » 

dsgetq'num'of 'entries=dsgetq'bufptr#, 

« the first word of DSGETQ indicates number of requests in>> 

« DSGETQ buffer *> 

dsgetq'ucno=dsgetq'entptr# , 

<< user channel number of this request associated with >> 

dsgetq ' req ' code=dsgetq ' entpt r ( 1 ) . ( 8 : 8 ) # , 

« if dsgetq' ioqindex <> 0, this word has the following >> 

<< definition: >:> 

<< >> 

« 1 - DS call request » 

« 2 - reserved for PAD call (PAD emulator) >> 

<< 3 - call clear request >> 

<< U - level- I/O request » 

« 5 - level-l I/O request (PAD messages) >> 

<< 6 - interrupt request >> 

<< Y - restart request ** 

<< 8 - reset request >> 

« 9 " info request >> 

dsgetq' status =dsgetq'entptr(l) . (8:8)#, 

« if dsgetq' ioqindex = 0, this word has the following >> 

<< defintion: ** 

<< >> 

<< 3 - incoming clear has been completed >> 

<< 5 - incoming reset has been completed >> 

dsgetq' subcode=dsgetq'entptr(l) . (0:8)#, 

<< if dsgetq' ioqindex <> and requestor is a PAD driver, >> 

<< this byte has the following definition: >> 

<< >> 

<< - read terminator is a carriage return >> 

<< 1 - read terminator is a record seperator >> 

<< 2 - read terminator is a non-printing character >> 

<< >> 

<< otherwise, this byte should be zero >> 
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dsgetq'ioq index =dsgetq 'entptr (2)#, 

<< the ioqindex associated with this request 

dsgetq'odesl=dsgetq'entptr(3)#, 
dsgetq 'odstl=dsgetq'entptr(3)#, 
dsgetq ' oaddrl=dsgetq ' entptr ( k ) # , 
dsgetq'olenl=dsgetq'entptr(5)#, 

<< the first piece of the outgoing message 

dsgetq * idesl=dsgetq ' entptr ( 6 ) # , 
dsgetq' idstl=dsgetq' entptr (6 )#, 
dsgetq ' iaddrl=dsgetq ' entptr ( 7 ) # » 
ds getq ' i lenl =ds getq ' entptr ( 8 ) # , 

<< the first buffer for the incoming message 

dsgetq' odes2=dsgetq' entptr (9 )#, 
dsgetq ' odst2=dsgetq ' entptr (9 ) # , 
dsgetq ' oaddr2=dsgetq ' entptr ( 10 ) # , 
dsgetq 'olen2=dsgetq' entptr (11 )#, 

<< the second piece of the outgoing message 

dsgetq' ides 2=dsgetq' entptr (12)#, 
dsgetq ' ids t 2=dsgetq ' entptr ( 12 ) # , 
dsgetq ' iaddr2=dsgetq ' entptr ( 13 ) # , 
dsgetq' ilen2=dsgetq ' entptr (lU)#, 

<< the second buffer for the incoming message 

dsgetq ' odes3=dsgetq ' entptr ( 15 ) # , 
dsgetq'odst3=dsgetq'entptr(15)#, 
dsgetq ' oaddr3=dsgetq ' entptr ( 16 ) # , 
dsgetq 'olen3=dsgetq' entptr (17)#, 

<< the third piece of the outgoing message 

dsgetq ' ides3=dsgetq ' entptr (18 ) # , 
dsgetq ' idst3=dsgetq ' entptr (18 ) # , 
dsgetq ' iaddr3=dsgetq ' entptr (19 ) # , 
dsgetq' ilen3=dsgetq 'entptr ( 20 )#, 

<< the third buffer for the incoming message 

dsgetq 'mainpin=dsgetq ' entptr ( 21 ) # ; 

<< the main pin associated with this request 
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dsputq' fc=#21, 

<< ATTACHIO function code for DSPUTQ request >> 

dsputq ' entlen=8 , 

<< each request entry size in DSPUTQ buffer >> 

dsputq 'buflen=dsputq'entlen*max'num' of 'entries+1; 

<< the total buffer size for the DSPUTQ request » 

dsputq'num'of 'entries=dsputq'bufptr#, 

<< number of request/reply entries in DSPUTQ buffer >> 

dsputq 'ucno=dsputq ' entptrf , 

<< user channel number associated with this entry >> 

dsputq ' ioqindex=dsputq ' entptr ( 1 ) # , 

<< ioqindex associated with this entry >> 

dsputq' dst = dsputq * entptr ( 2) #, 
dsputq 'addr = dsputq 'entptr (3 )#, 
dsputq 'len = dsputq ' entptr (*4)#, 

<< the descriptor for the unsolicit incoming message >> 
<< or in DS message case, this will be the descriptor for >> 

<< the actual user data portion, the length shows the >> 
<< actual data received even if a truncation happened due >> 

<< to insufficient buffer size >> 

dsputq ' req ' code=dsputq ' entptr ( 5 ) # > 

<< if dsputq 'ioqindex = 0, this word has the following >> 

<< definition: >> 

<< >> 

<< 1 - unsolicit incoming data ( level-0 ) >> 

<< 2 - unsolicit incoming data ( level-1 ) >> 

<< 3 " incoming clear >> 

<< k - incoming interrupt >> 

<< 5 ~ incoming reset » 

<< » 

« otherwise, the request code will be the same as given >> 

<< in the DSGETQ » 

dsputq ' status =dsputq * entptr (6 ) # , 

<< if dsputq' ioqindex <> 0, this is the completion status >> 

<< for the given ioqindex, otherwise should be zero >> 
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dsputq'uctype=dsputq'entptr(7). (0:8)#, 

<< there are three different types of user channels: >> 

<< >> 

« - HP3000 to HP3000 channel » 

« 1 - HP3000 to PAD channel >> 

« 2 - HP3000 to HP1000 channel » 

dsputq'mainpin=dsputq'entptr(7) • (8:8)#; 

<< the main pin associated with the given user channel >> 
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I 
+- 



DSMONG & DSMONP buffer format 
DSMONG BUFFER DSMONP BUFFER 



# OF ENTRIES 



ENTRY 1 



ENTRY 2 



ENTRY N 



+- 
i 



ENTRY FORMAT 






ENTRY 1 



ENTRY 2 



ENTRY N 



l 

-+ 



REQUEST CODE 
PARAMETER 
IOQINDEX 

PARAMETER DESCRIPTOR 



i 
+ - 



I 
+ - 



IOQINDEX 
STATUS 
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dsmong 'fc=%22, 

<< ATTACHIO function code for DSMONG request 

dsmong'entlen = 6, 

<< the entry size for each request in DSMONG buffer 

dsmong'buflen = dsmong'entlen * max 'monreq' entries + 1; 

<< the buffer size for DSMONG request 



dsmong 'num 'of 'entries = dsmong 'bufptr#, 
dsmong ' req ' code =dsmong ' entptr# , 
dsmong 'parm = dsmong'entptr(l)#, 
dsmong' ioq index = dsmong' entptr (2 )#, 
dsmong 'des = dsmong' entptr (3 )#» 
dsmong 'dst = dsmong'entptr(3)#, 
dsmong 'addr = dsmong 'entptr (**)#, 
dsmong 'len = dsmong ' entptr ( 5 )# ; 



<< the requests in DSMONG 
<< following table: 



buffer are defined in the 



« COMMAND 


REQ' CODE 


PARM 


DESCRIPTOR 


« OPEN 


3 


%(2)11 


LINE 'SPEED 


« OPEN MASTER 


3 


%(2)10 


LINE' SPEED 


« OPEN SLAVE 


3 


91(2)01 


LINE 'SPEED 


« SHUT 


3 


%(2)00 


LINE 'SPEED 


« TRACE ON 





CTRACEINFO 


TRACE 'FILE 


<< TRACE OFF 


1 






« MON 


7 


%(2)111 




« MON DS 


7 


%(2)011 




« MON CS 


7 


Jt( 2)101 




« MOFF 


7 


%(2)000 




« DEBUG ON 


%10 


1 




« DEBUG OFF 


#10 







« DEBUG N 


JtlO 


N 





>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
>> 
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dsmonp 'fc=?£23, 

« ATTACHIO function code for DSMONP request 

dsmonp ' entlen=2 , 

<< the entry size for each request in DSMONP buffer 

dsmonp ' buf len=dsmonp ' ent len*max ' monreq * entries+1 ; 

« DSMONP buffer size 

dsmonp ' num ' of ' entr ies=dsmonp ' buf ptr# , 

<< number of entries in DSMONP buffer 

dsmonp' ioqindex = dsmonp ' entptr# , 

<< the completed ioqindex 

dsmonp* status = dsmonp' entptr(l)#; 

<< the completion status associated with the ioqindex 
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DSMONX 
USER CHANNEL INFORMATION TABLE 



T 
R 
A 
N 
S 
M 
I 
T 
T 
E 
R 



R 
E 
C 
E 
I 
V 
E 
R 



POINTER TO NEXT UCIT 



A|M|L|W|L'| 



| TYPE 



REQUEST QUEUE POINTER 



T-REQUEST CODE | 



T-MAINPIN 



T-IOQINDEX 



T-DATA DESCRIPTOR 1 



T-DATA DESCRIPTOR 2 



T-DATA DESCRIPTOR 3 



TOTAL MESSAGE LENGTH (IN PACKETS) 



PACKETS ACKNOWLEDGED 



PACKETS LEFT 
R-IOQINDEX 



R-DATA DESCRIPTOR 1 



R-DATA DESCRIPTOR 2 



R-DATA DESCRIPTOR 3 



UNSOLICIT DATA DESCRIPTOR 



TOTAL MESSAGE RECEIVED IN BYTES 



TOTAL UNSOLICIT MSG RCVD IN BYTES 



R -REQUEST CODE 



I 



R-MAINPIN 



READ TYPE 
SPECIAL REQUEST IOQINDEX 



CURRENT VCIT CONNECTED 



STATUS 



REMOTE NODE NAME IN ASCII (8 BYTES) 



HIGH LEVEL BUFFSIZE 
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ucit'entlen = 1*1; 

« user channel information table size >> 

ucit'nextent = ucit'entptr#, 

<< pointer to next free UCIT, used only in free list >> 

ucit'a'bit = ucit'entptr(l) . (0:1)#, 

<< indicate the UCIT is currently allocated if set >> 

ucit 'master = ucit'entptr(l) . (1:1)1, 

<< indicate the local end is the call originator if set >> 

ucit'msglevel = ucit'entptr(l) . (2:1)#, 

<< indicate a level-1 message is sent if set >> 

ucit'wait = ucit'entptr(l). (3:1)#, 

<< indicate this UCIT is dequeued from active UC queue >> 
<< because the associated VC is busy if set >> 

ucit'msglevel' = ucit'entptr(l) . (U:l)#, 

<< indicate the message currently received is a level-1 >> 
<< pad message if set >> 

ucit'type = ucit'entptr(l) . (13:3)#, 

<< - remote is DS/3000 >> 

<< 1 - remote is PDN PAD >> 

<< 2 - remote is DS/1000 >> 

ucit' next' ucioqp = ucit'entptr(2)#, 

<< point to next request queued onto this UCIT >> 

ucit'wreqcode = ucit'entptr(3) . (0:8)#, 

<< write request code, same definition as in DSGETQ >> 

ucit'wmainpin = ucit'entptr(3) . (8:8)#, 

<< the mainpin associated with this write request >> 

ucit'wioq = ucit'entptr(U)#, 

<< the ioqindex associated with this write request >> 

ucit'odesl = ucit'entptr(5)#, 

uw .l la uua ux — uv. j. v e±± u£/ bl \ ^ f w , 
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ucit'oaddrl = ucit'entptr(6)#, 
ucit'olenl = ucit'entptr(7)#, 

« the first piece of the outgoing message ( DS HEADER ) » 

ucit'odes2 = ucit'entptr(8)#, 

ucit'odst2 = ucit'entptr(8)#, 

ucit'oaddr2 = ucit'entptr(9)#, 

ucit'olen2 = ucit'entptr(lO)#, 

<< the second piece of the outgong message (DS APPENDAGE) » 

ucit'odes3 = ucit'entptr(ll)#, 

ucit'odst3 = ucit'entptr(ll)#, 

ucit'oaddr3 = licit' entptr( 12 )#, 

ucit'olen3 = ucit'entptr(13)#, 

« the third piece of the outgoing message (USER DATA) » 

ucit'no'of'pckts = ucit'entptr(ll»)#, 

<< total number of packets worth of the outgoing message >> 

ucit'pckts'acked = ucit'entptr(15)#, 

<< total number of packets being acknowledged so far >> 

ucit'pckts'left = ucit'entptr(l6)#, 

« number of packets left to be transmitted >> 

ucit'rioq = ucit'entptr(17)#, 

<< the ioqindex associated with read, maybe the same value>> 
<< as write ioqindex if a writeconversational request >> 

ucit'idesl = ucit'entptr(l8)#, 

ucit'idstl = ucit'entptr(l8)#, 

ucit'iaddrl = ucit'entptr(19)#, 

ucit'ilenl = ucit'entptr(20)#, 

<< the first buffer for incoming message (DS HEADER) >> 

ucit'ides2 = ucit'entptr(21)#, 

ucit'idst2 = ucit'entptr(21)#, 

ucit'iaddr2 = ucit'entptr(22)#, 

ucit'ilen2 = ucit'entptr(23)#, 

« the second buffer for incoming message (DS APPENDAGE) >> 

ucit'ides3 = ucit'entptr(2l+)#, 

ucit'idst3 = ucit'entptr(2lt)#, 

ucit'iaddr3 = ucit'entptr(25)#, 

ucit'ilen3 = ucit'entptr(26)#, 
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<< the third buffer for incoming message (USER DATA) >> 

ucit'ides^ = ucit'entptr(27)#, 

licit' ids tU = ucit'entptr(27)#, 

ucit'iaddrU = ucit'entptr(2S)#, 

ucit'ilenU = ucit'entptr(29)#, 

<< the temporary buffer used by DSMONX to keep unsolicit >> 
<< messages >> 

ucit'rleni23 = ucit'entptr(30)#, 

<< the total length (in bytes) of the incoming message >> 

ucit'rlenU = ucit'entptr(31)#, 

<< the total length of the unsolicit incoming message >> 

ucit'rreqcode = ucit'entptr(32) . (0:8)#, 

« the read request code , same definition as in DSGETQ >> 

ucit'rmainpin = ucit'entptr(32) . (8:8)#, 

<< the mainpin associated with this read request >> 

ucit'intioq = ucit'entptr(33)#, 

<< the ioqindex associated with interrupt request >> 

ucit'vcit'entptr = ucit'entptrO 1 *)!, 

<< the VCIT associated with this UCIT » 

ucit' status = ucit'entptr(35)#» 

<< the completion status of the completd ioq >> 

ucit'lnode = ucit'entptr(36)#, 

<< the remote logical node name in ASCII form >> 

ucit'buffsize = ucit*entptr(UO)#; 

<< the buffer size used by high level DS software >> 
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DSMONX 
VIRTUAL CIRCUIT INFORMATION TABLE 



POINTER TO NEXT VCIT 


CURRENTLY CONNECTED 


UCIT 




VIRTUAL CIRCUIT NUMBER 


RETRY COUNT 


P'(S) I 


P(S) 




LWE | 


W 




LWE' | 


W 




| WA 


QlQ'UU'l |M|M'| 




IF 


TIMER LENGTH 


TIMER ENTRY POINTER 
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vcit'entlen = 11; 

<< the size of virtual circuit information table in words >> 

vcit'nextent = vcit'entptr#, 

<< pointer to next available VCIT in free list >> 

vcit'ucit'entptr = vcit'entptr(l)#, 

« pointer to the associated UCIT which connected to >> 

vcit'vcno = vcit'entptr(2)#, 

<< the virtual circuit number relative to LOW'VC >> 

vc it' retry 'cnt = vcit'entptr(3)#, 

<< the retry count, for clear and reset requests >> 

vcit'p's ~ vcit'entptr(U).(0:8)#, 

<< send packet sequence number of last received data pckt >> 

vcit'ps = vcit*entptr(*+).(8:8)#, 

<< send packet sequence number of the ready-to-be-send >> 
<< data packet >> 

vcit'lwe = vcit'entptr(5).(0:8)#, 

<< local receiving buffers' lower window edge, >> 

<< LWE <= data packet < = LWE+W-1 are legal if not out of >> 
<< sequence >> 

vcit'w = vcit'entptr(5).(8:8)#, 

<< local window size » 

vcit'lwe' = vcit'entptr(6). (0:8)#, 

<< remote receiving buffers' lower window edge, local site>> 
<< should send data packet only within >> 

« LWE' <= data packet <= LWE'+W'-l » 

vcit'w* = vcit'entptr(b). (8:8)#, 

<< remote window size >> 

vcit'wa = vcit'entptr(7).(8:8)#, 

<< the number of data packets outstanding allowed before >> 
<< RR to remote >> 
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vcit'qbit = vcit'entptr(8) . (0:l)#, 

<< indicate if Q-bit should be set or not when sending >> 

vcit'qbit' = vcit'entptr(8) . (1:1)#, 

« indicate if Q-bit is set or not when data received » 

vcit'ibit = vcit'entptr(8).(2:l)#, 

<< indicate there is a interrupt request outstanding >> 

vcit'ibit' = vcit'entptr(8).(3:l)#, 

<< indicate an interrupt indication has been received but >> 
<< has not been confirmed yet >> 

vcit'mbit = vcit'entptr(8) . (8:1)#, 

<< indicate M-bit should be set when sending >> 

vcit'mbit' = vcit'entptr(8) . (9:1)#, 

<< indicate M-bit is set when data received >> 

vcit'f'bit = vcit'entptr(8).(15:l)#, 

<< indicate the remote window is temporarily closed >> 

vcit'timer = vcit'entptr(9)#, 

<< indicate there is a timer outstanding if <> -1 >> 

vcit'tmr'entptr = vcit'entptr(10)#; 

<< index to associate the outstanding timer in TRL » 
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DSMONX Layout 



DL — > 



DB --> 



VCIT 



GLOBAL VARIABLES 



TIMER REQ LIST 



ACTIVE UC QUEUE 
VC ALLOCATION TABLE 



UCIT 



S — > +- 




+ 

I 
TEMPBUF | 

1 

i 

I 

-+ 



DST 
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UPPER LEVEL DS/3000 TABLES 



DS INFO DATA SEGMENT 
The data segment no. for this XDS is in DSGLOBINFO(3) 
DSGLOBINFO is a table in DSGLOBAL data segment. 



TABLE 'SIZE 
ENTRY 'SIZE 
NUMLDEVS 
LDEVSLISTSTART 



1 2 3 ^ 5 6 7 8 9 10 11 12 13 lU 15 
Number of real entries 



Entry size 
Number of IODS0 ldevs 
First IODSO ldev 
Second IODSO ldev 



Last IODSO ldev 






Entry 


for 


first 


PIN 


Entry 


for 


second 


PIN 



Entry for last PIN 



*o 





911 


1 


%2 


2 


*3 


3 


%u 


It 
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JOBNOX 

TERMNOX 

NAMEX 

ACCTX 

FIRSTLDEVX 



FORMAT FOR AN ENTRY IN THE DS INFO DATA SEGMENT 
1 2 3 ** 5 6 7 8 9 10 11 12 13 lU 15 

iiiiiiiiiiiti(**i 

S/J I 



Job number 



| Terminal number 



User name (four words) 



User account (four words) 



Info on first IODS0 ldev 
(two words) 



Info on second IODS0 ldev 
(two words) 



Info on last IODS0 ldev 



%o 





%1 


1 


%2 


2 



%6 6 

%12 10 
%lk 12 



NOTES 

S - Session 

J - Job 

The code for S or J is the same as in the Job 

Information Table. (JIT) 
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ENTRYLDEVX 
ENTRYLDEVX1 



FORMAT FOR INFO ON AN IODSO LDEV 
(THIS INFORMATION IS FOR EACH PIN) 

1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 



Number of DSOPENs | IODSO ldev 
L| N| M| S| X| C| Q| ////////////////////////// 



960 o 

%i l 



NOTES 

ENTRYLDEVX 
No of DSOPENS 

IODSO ldev 



- This corresponds to the PIN and IODSO 
ldev under consideration. 

- The logical device number of the IODSO 
device under consideration. 



ENTRYLDEVX1 
L - On if the PIN is on the remote (slave) side of 

the DS line. 
N - On if a session exists for the PIN. 
M - On if Master access is opened for this DS line. 
S - On if Slave access is opened for this DS line. 
X - On if the user has exclusive access over the DS line. 
C - On if the user has set the compress option for the 

DS line. 
Q - On if the user has set the quiet option for the DS 

line. 
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NOTES ON THE DS INFO DATA SEGMENT 

This XDS contains information that is global to 
the system. Entry zero contains some header 
information . The number of real entries is the 
no of PINs allowed on the system. The ENTRY' SIZE 
is variable with each system and is: 

ENTRY' SIZE = FIRSTLDEVX + NUMLDEVS*2 
This allows two words of information for each 
I0DS0 Idev. Real entries contain information only 
if the corresponding PIN is alive and at least 
one DSOPEN has been executed by that PIN. If the 
first word of the entry is non-zero then it has 
information according to the above format else 
all the other words are also zero. An entry 
contains information on IODSO ldevs in the same 
order as in the header entry. A non-zero entry 
has non-zero information on all IODSO ldevs for 
which at least one DSOPEN has been executed. This 
XDS is initialized as a fixed size data segment 
at system startup time. 
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1 

2 
3 



DS AFT 
AVAILABLE FILE TABLE 



( FSTYPE = 1 ONLY ) 
1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 



FSTYPE | UNUSED 


=l==l==l==l==l== 
|MR 


RFNUM | 


LINENUM 


RESERVED FOR FUTURE USE 


(SET TO ZERO) 


IOQX 



.AFTO 
.AFT1 
.AFT2 
.AFT3 



NOTES 

AFTO 

FSTYPE - = Local File 

1 = Remote File 

2 = DSNUM 

3 = DSNUM (No Wait) 
U = CS File 

5 = CS File (With Auto Dial) 

6 = KSAM 

MR - Multi-record access 

AFT1 

RFNUM - Remote file number 

LINENUM - Local line number of remote file 

AFT2 

Not currently used. 

AFT3 

IOQX - No wait IOQX 
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1 

2 
3 



DS AFT 
AVAILABLE FILE TABLE 
( FSTYPE = 2 OR 3 ) 

1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

FSTYPE | C| M| P| R| LDEV NUM | .AFTO 

DSDSCB INDEX | DSDST NUM 1 .AFT1 

PREVIOUS AFT POINTER | DS ERROR NUM j .AFT2 

IOQX | .AFT3 



NOTES 

AFTO 

FSTYPE - = Local File 

1 = Remote File 

2 = DSNUM 

3 = DSNUM (No Wait) 
U = CS File 

5 = CS File (With Auto Dial) 

6 = KSAM 

C - On if DSOPEN called by CXDSLINE or REMOTE' HELLO. 

M - On if Master PTOP AFT. 

P - On if PTOP related. 

R - On if remote main process. 

LDEV NUM - Logical device number. 

AFT1 

DSDST NUM - DS Data segment table pointer. 
DSDSCB INDEX - DS Dataseg control block index. 

AFT2 

PREVIOUS AFT POINTER - Preceding DS open AFT Pointer. 
DS ERROR NUMBER - DS error number. 

AFT3 

IOQX - No wait IOQX 
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OVERALL SESSION/JOB DS DATA STRUCTURE 



%lk 



+ > 



Job Info Table] | 
I I 
I I 



(Job DS XDS)- 



Job DS XDS 










+--> 



AFT (ldev b) + | 

I I 

AFT (ldev a) + 



I 



(Job DS XDS)- 






Device Process 

DS XDS 

(ldev a, CI) 



+ — > 



-+ | (Job DS XDS)- 



I Device Process I 

DS XDS 

(ldev b, CI) 



-+ +- 










+--> 



+ — > 



AFT (ldev b) + | 

1 | 

AFT (ldev a) + 

I I 

AFT (ldev a) + 

I 

I 



j j (Job DS XDS) + j (Job DS XDS)- 



I Device Process | 

DS XDS 

(ldev a, SON) 



| Device Process | 

DS XDS 

(ldev b,SON) 
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DS -RELATED PCBX STRUCTURES 



PXGLOBAL 
PXFILE 



+ Last DS AFT | Slave DS AFT- 



AFT 

DSNUM z -->+-> 



DSNUM y-->+-> 



+-- 



I 
DSNUM x-->+-> 



u<- 



DL 



DSOPEN Error ! CSOPEN Error 



00101 |M|P|R| | DS Ldev 



DSCB index | DevProc DS XDS --- 
- Previous AFT | DS Error Num 
IOQX 



00101 |M|P|R| | DS ldev 



DSCB index | DevProc DS XDS --- 
- Previous AFT ! DS Error Num 
IOQX 



0010 | |M|P|R| | DS ldev 



DSCB index | DevProc DS XDS --- 
- Previous AFT j DS Error Num 
IOQX 





1 
2 



■> DSCB in Dev- 
Proc DS XDS 



-> DSCB in Dev- 
Proc DS XDS 



<-+ 



-> DSCB in Dev- 
Proc DS XDS 
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JOB DS EXTRA DATA SEGMENT 



DSDSMAXSIZE 
DSDSALLOC 
DSDSFREESPPT 
DSDSOPENS 



l 2 3 ** 5 6 7 8 9 10 11 12 13 1H 15 
+ «|„|„|„|«|«|»| BS |«|«|..|--I--I--I»I--+ 
Maximum size of Job DS XDS (l6K Max.) 

Present size of Job DS XDS 

Pointer to free space area 

Number of DSOPENs active in this job 

Print Buffer Pointer (SEG REL) 

Print Buffer Size (+WORDS) 



DSLCBX area 

(one DSLCBX 
for each 
network 
node, 
max. 8 ) 



DSLCB area 

(one DSLCB 
for each 
configured 
DS device) 



Unused 



Job DS Line Control Block Extension 
for open device 



Job DS Line Control Bolck Extension 
for open device 



Job DSLCB for first opened device 



Job DSLCB for second opened device 



Job DSLCB for last opened device 



%o 





%1 


1 


%2 


2 


%3 


3 


%u 


It 


%5 


5 



%1U 12 



JfcLlU 76 



J4120 80 
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Print Buffer 



I --- 

i 

| Size of free area (+words) f 
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DEVICE/PROCESS DS EXTRA DATA SEGMENT 



DSDSMAXSIZE 

DSDS ALLOC 

DSDSFREESPT 

DSDSOPENS 

DSDSRFAPT 

DSDSRFASIZE 

DSDSIMAGE'PT 

DSDSCOMPBUFP 

DSDSCOMPBUFSZ 

DSDSJOBXDS 



DSCB Pointer 
Area 

(one for 
each DSOPEN 
in process 
for device; 
6k maximum) 



DSLCB Area 

(one for each 
configured 
DS device; 
but only one 
used) 



1 2 3 *♦ 5 6 7 8 9 10 11 12 13 lU 15 
+== |«|==|==|==l==l==l==l==l==l==l==l==l==l==l==+ 
Maximum size of this DS XDS (=l6K) 

Present size of this DS XDS 

Pointer to free space area 

No. of DSOPENs in process for device 

RFA buffer pointer 

RFA buffer size (+words?) 

IMAGE control block pointer 

Compression buffer pointer 

Compression buffer size (+words?/2) 

Job DS XDS data segment number 

Reserved as a temporary sratchpad area 

Multi-Packet total message length (+bytes) 



Pointer to DSCB for first DSOPEN 



Pointer to DSCB for second DSOPEN 



Pointer to DSCB for last DSOPEN 



DSLCB for device and process 



%o 





%1 


1 


%2 


2 


%3 


3 


%h 


k 


%5 


5 


16 


6 


%1 


7 


%10 


8 


%ii 


9 


%12 


10 


%13 


11 


JtLU 


12 


%15 


13 



5S113 75 
%11U 76 

JJ120 80 
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DSCB Area 

(elements in 
any order) 



BS Control Blocks (DSCBs) 
(one for each DSOFEN) 



Remote File Access (RFA) Buffer 
(one for slave side only) 



Program-to-program (PTOP) Buffer 
(one for slave side PTOP only) 



IMAGE Control Block 
(one for remote IMAGE only) 



Compression Buffers 
(two for corap, READ/PRINTs)?? 



Size of free space area (+words?) 



Free Space Area 
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DS LINE CONTROL BLOCK (DSLCB) 



1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 
No. DSOPENS for device | Logical device number 
User Channel Number | From process number 
///////////|UC|QQ|Q1|Q0|C1|UP|RF|HI|PM|PG|PS|RS 
DS device buffer size (+words) 



DSLCBCOUNT 
DSLCBLDEV 
DSLCBRMPNUM 
DSLCBFRMNUM 
UC - DSLCBUCF 
QQ - DSLCBQTOQ 
Ql - DSLCBQUIET1 
Q0 - DSLCBQUIETO 
CI - DSLCBCOMP 
UP - DSLCBSESSION 
RF - DSLCBFOPEN 
HI - DSLCBHELLOOP 
PM - DSLCBPTOPMSTR 
PG - DSLCBPTOPGET 
PS - DSLCBPTOP 
RS - DSLCBRMPFLAG 
DSLCBBUFSIZE 



No of DSOPENs for device 
Logical device number 
From process number 
From process number 
User Channel on this line 
QTOQ flag 

Suppress next output 
QUIET mode specified 
Compress on this line 
Remote session up 
Remote FOPEN in progress 
DSOPEN on REMOTE HELLO 
PTOP master on this line 
Slave PTOP was GET 
PTOP slave on this line 
Process is remote slave 
DS device buffer size 



Job Device -process 
DSLCB DSLCB 
x x 

X X 

X 
X 
X 



X 
X 
X 



X 
X 



X 
X 



X 
X 
X 
X 
X 
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# o 

1 

2 
3 
U 

5 
6 

7 



DS Line Control Block Extension (DSLCBX) 

1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

I == I == I == I == I == I == I == I == I == I == I == I == I == I == I == I == I 

iiiiiiiiiiiiiiiii 

Logical Device Number j User Channel Number 



Logical 
Node 
Name 



Virtual Buffer Size 



I s 



%0 
1 
2 
3 

5 
6 

7 



NOTES 

S => DSLCBX entry is remote slave 
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DS 



DSLCBPT 

DSPROGNUM 

DSIOCLASSNUM 

DSTERMNUM 

DSPTOPBUFPT 

DSPTOPBUFL 

DSRMTLENGTH 

DSPTOPFUNCT 

HEADBUF(O) 
HEADBUF(l) 
HEADBUF(2) 
HEADBUF(3) 
HEADBUF(U) 
HEADBUF(5) 
HEADBUF(6) 
HEADBUF(7) 



CONTROL BLOCK (DSCB) WITH MESSAGE HEADER FORMAT 
1 2 3 1» 5 6 7 8 9 10 11 12 13 1U 15 



! |«|„|„|™|„|«| == |„|: 



Pointer to DSLCB for opened DS device 



Program number (only for remote RTE) 
I/O class number (only for remote RTE) 



Terminal number (only for remote RTE) 
PTOP buffer pointer 



PTOP buffer size (+words??) 

PTOP transfer length (+words/-bytes??) 



PTOP function code (from last GET) 
/////////////////////////////////////////////// 



Headlength (+words) | Message class 
Remote computer id (always 0) 



R| E| C| B|C0| P|/////| Stream type 
Substream type (always 0) 



From process number | To process number 
/////////////////////////////////////////////// 



/////////////////////////////////////////////// 
Dsdatal (Appendage + data length, +bytes) 



Appendage Section 
(see message formats for specifics) 



Unused (for appendage) 




1 
2 
3 
it 

5 
6 

7 



%0 
%1 
%2 
543 

565 
%6 
%7 



8 %10 

9 %H 

10 %12 

11 %13 

12 %lk 

13 %15 
1U %16 

15 JH7 

16 %20 

17 5621 

18 5622 



153 56231 
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HEADER Definitions: 

HEADLENGTH - length of header and appendage (+words) 

MESSAGETYP - classifies message 

CGMPUTERID - unused 

R - REPLYRECORD - on if message is a reply 

E - REJECTRECORD - on if message has been rejected 

C - CONTUFOLLOW - on if continuation record to follow 

CO - CQMPREC - on if data in message is compressed 

B - ??? - on if in "break mode 

P - KOT'IN'PTOP - on if in master PTOP mode 

STRMTYP - identifies message within message class 

SUBSTRMTYPE - unused 

FROMPROCESS - PIN of process from which message transmitted 

TOPROCESS - PIN of process to which message sent 

DSDATAL - length of appendage and data (+bytes) 
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POINTER LINKAGE IN DEVICE/PROCESS DS XDS 



+ --> 



Maximum DS XDS size 
Present DS XDS size 
Free space pointer - 
Number of DSOPENs 
RFA buffer pointer - 
RFA buffer size 
IMAGE CB pointer 
Comp. buffer pointer- 
Comp. buffer size/2 
Job DS XDS number 



First DSCB pointer 



Second DSCB pointer 



DS Line Control Block 



Compression Buffer (s) 



DSLCB pointer 



First DS Control Block 



IMAGE Control Block 



< + 
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RFA Buffer 



DSLCB pointer 



PTOP buffer pointer 



Second DS Control Block 



PTOP Buffer 



< + 



Size of free space area 



I 

I 

-+ 



Free space 
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DESCRIPTION OF SESSION/JOB DS DATA STRUCTURE 



OVERALL SESSION/ JOB DS DATA STRUCTURE 

Each session and job which is using DS has its own data structure 
consisting of a set of extra data segments and areas within MPE tables, 
The MPE structures include: 

. Job Information Table (JIT): one word with the data segment 

number of the job's DS extra data segment. 
. Available File Table (AFT) entries: one for each active DS 

service within each process. 

The DS extra data segments provide space for control information and 
data buffers. There are two types: 

. Job DS XDS: one for the entire job/session, with global DS 

information. 
. Device -process DS XDS: one for each remote system (i. e., DS 

device) being accessed by each process. 

The following is a sample list of actions and the DS data structures 
created by those actions : 



ACTIONS 
:DSLINE to DS device a 

:DSLINE to DS device b 
:RUN son process 



CREATED STRUCTURES 

Job DS XDS; sets JIT pointer 
DeviceProcess DS XDS for ldev a, CI 
AFT (to ldev a) in CI stack 
DeviceProcess DS XDS for ldev b, CI 
AFT (to ldev b) in CI stack 



POPEN to DS device a 

FOPEN to DS device a 
POPEN to DS device b 



DeviceProcess DS XDS for ldev a, SON 
AFT (to ldev a) in SON stack 
AFT (to ldev a) in SON stack 
DeviceProcess DS XDS for ldev b, SON 
AFT (to ldev b) in SON stack 
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AFT AND PCBX STRUCTURES 

The PCBX area, at the beginning of each process stack below the 

DL address, is used by MPE, the File System, and datacomm subsystems 

to hold process -related information. 

The File System's Available File Table (AFT) is the primary structure 
used by DS. Each DS service (remote commands, remote files and data 
bases, PTOP, etc.) in use by the process has assigned an AFT entry. 
An active DS service is identified by a DS number, which is equivalent 
to an opened file's file number. The DS number is used to index into 
the AFT to select the proper entry. Since the AFT starts at the end 
of the PCBX and grows back towards the beginning of the segment, DS 
numbers are used to compute a DB-minus address with the formula 

AFT address (relative to DB) := DL address - AFTsize * DSnumber 

There are two types of AFTs associated with DS: 

A DS AFT supplies limited information about the DS service, 
including the Idev of the DS device to the remote. The DSCB Vector 
(word 2 of the AFT) specifies the DS Control Block in the 
Device-process DS XDS associated with the service. Each successful 
call to DSOPEN creates a new DS AFT. The AFT is deleted by DSCLOSE 
when the service is terminated. 

A REMOTE FILE AFT is created by the File System when a remote 
file is FOPENed in a local process. It supplies the file number to 
be used by the remote File System (RFNUM) and the DS number of the 
DS AFT created for the remote file. 

The active DS AFTs are linked in a chain, with the Last DS AFT field 
(PXFILE(3). (0:8)) giving the DS number of the most recently created 
DS AFT, and each Previous AFT field supplying the DS number of the 
preceding DS AFT. If the process is a remote CI, the slave DS AFT 
field (PXFILE(3). (8:8)) indicates the DS number of the DS AFT opened 
to reply to the master. Otherwise, the slave DS AFT field is zero. 

Finally, error numbers for the last DSOPEN and COPEN executed are 
held in PXFILE(l). DSCHECK and CCHECK can look there for errors on 
opens . 
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JOB DS EXTRA DATA SEGMENT 

The job DS XDS contains information that is global to the job, and 
is known to all processes using DS within the job. This includes 
the total number of active DS services (DSOPENs) and some control 
information for each DS device (line to a remote) access by the 
session. The job DS XDS has the same general format as the Device - 
Process DS XDS, with the unused data structures deleted. 



DEVICE -PROCESS DS EXTRA DATA SEGMENT 

A device-process DS XDS is created for each DS device (remote system) 
in use within the process. It holds control information and data 
buffers to be used for the process' communication with the remote. 
Originally (see above) there was only one DS XDS for all processes, 
but it was discovered that certain types of concurrent DS activity 
required separate sets of buffers and control blocks. The current 
data segment per device per process scheme solves these problems. 
Each of these segments has essentially the same format as the old 
DS XDS, so changes to DS code have been minimized. 

Elements of the device-process DS XDS: 

. DSCB pointer area: holds up to 6k pointers that link AFTs to 

DSCBs 
. DSLCBs: see below; only one DSLCB in the segment 
. DSCBs: see below 
. RFA buffer: used for intermediate buffering of remote FREAD 

and FWRITE data 
. PTOP buffer: used for intermediate buffering of PWRITE data 

on the slave side 
. IMAGE control block: holds plabels for IMAGE intrinsics used 

in processing remote data base access requests; dynamically 

loaded via LOADPROC when the first remote DBOPEN executed. 

(When DS was released, both DS and IMAGE were optional 

products, so calls to IMAGE from DS could not be coded 

directly. ) 
. Compression buffers: one or two (depending on your point of 

view) buffers used during compression and decompression 

of data; also used to hold READ and PRINT data to and 

from the remote pseudo terminal. 
DS LINE CONTROL BLOCK (DSLCB) 

The DS Line Control Block holds control information pertaining to 
the use of a DS device, that is, access to a remote system. There 
are two types of DSLCBs: 

There is a JOB DSLCB (in the Job DS XDS) for each DS device 
being accessed by any process within the job. This DSLCB 
holds control information that is global throughout the job 
and/or must be available to all processes in the job. Some 
of this information is used for occasional processing, like 
the establishment and termination of the remote session 
(DSLCBHELLOP, DSLCBSESSION) . A job DSLCB is created when a 
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:DSLINE DSdevice;OPEN is executed (the first DSOPEN for the 
DSdevice), and is destroyed when the :DSLINE DSdevice; CLOSE 
is performed. 

There is one DEVICE -PROCESS DSLCE in each Device-process 
DS XDS. This DSLCB contains information relating to a par- 
ticular process' access to a DS device. Some of the infor- 
mation is copied from the corresponding job DSLCB (e.g. 
DSLCBBUFSIZE, DSLCBLDEV) . Other fields are used in DS 
activity local to the particular process (e.g. DSLCBFOPEN, 
DSLCBPTOPGET) . The device-process DSLCB is created when 
its associated DS XDS is created (on the first DSOPEN in 
the process for the DS device), and is deleted when the 
DS XDS is released. 

These two types of DSLCBs resulted when the original single DS data 
segment was split for the Moulinex fix. The format of the original 
DSLCB was retained, but certain fields are maintained only in the 
job or the device -pro cess copies, and some fields are present in 
both. This was done on a functional basis -- those fields that are 
job-specific in nature and are rarely accessed are in the job DSLCB; 
those fields that are process -specific and/or frequently accessed 
are in the device-process DSLCB. Hopefully this minimizes the data 
segment switches, with most of the DS processing done with DB point- 
ing at a device-process DS XDS. 

NOTE: There are, unfortunately, TWO data structures called DS 
Line Control Blocks within DS. One (this one) is found in the DS 
XDSs and is used by the user services ("higher") level (DSSEG1- 
DSSEG5). The other is found in the DL-DB area of the DSMON process 
stack and is used by the DS 10 ("lower") level (DSIOM, DSMISC, IODS0, 
IODSTRMO). Do not confuse them! 
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DS CONTROL BLOCK (DSCB) 

A DS Control Block exists for each DS service in use by a process. 
Each DSOPEN (for a .-DSLINE, FOPEN of a remote file, POPEN, etc.) 
creates a DSCB, and the corresponding DSCLOSE deletes the DSCB. 
The DSCB holds control information specific to a service and pro- 
vides space for the header and appendage of messages relating to 
the service. There are three sections in the DSCB: 

. Miscellaneous control information 

. a pointer to the DSLCB for the remote system 

. three words used for messages to RTE (HP1000) remotes 

. four words used for PTOP slave processing 

. Message header - built by MANAGEWRITECONV for each request 
. message identification (class and stream type) 
. routing information (from and to processes) 
. various lengths (headlength, dsdatalength) 
. various status flags (rejection, continuation, etc.) 

. Message appendage - supplied by the caller of MANAGEWRITECONV 
contains request specific information (such as FOPEN para- 
meters). See Message Formats for details. 

The DSCB is always allocated as a 153 word block to hold the largest 
appendage. Normally there will be unused space after the appendage. 
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CS TABLES 



BINARY SYNCHRONOUS COMMUNICATION FOR CS DIT 






1 2 3 ** 5 


6 7 8 9 10 11 12 13 


lU 15 


o| 


-I — 1 " 
|AC| 
|TV| 
i i 




1 SI | IN | 

|0-|T-| 
i ON i AC | 


j DR | ON | 
|V-|LI| 
! EN j NE ! 


ll 






NEXT DITP 




2| 






IOQP 




31 


UNIT 


| DLDEVN 




*»l 


------- 




DLTP 




51 




ILTP 


1 


61 


|TO|LO| 

1 |c-| 

1 |T0| 




| 


71 


BARDWARE STATUS 




10 1 




RESERVED 




111 






CONTROL P 


1 


12 1 




] 


LCM' DITP 




131 




SDIT' DITP 




1U| 






PD' DITP 




|CM| 

(o)15|p-I 

|IN| 


|PW| 

IR-I 
|FL| 


| HD | SF | 

|AB|AB| 
IT |T | 


|T0| | BF | ID | US | 
| | |FZ|FZ|ER| 

till IRQ! 


|L0| | 
|C-| | 
|T0| | 


|CMj 

(D16IP-I 

|IN| 


ipwi 

IR-I 
|FL| 


| HD | SF | 

| AB | AB | 
IT |T | 


|T0| i BF j ID j US j 
I j |FZ|FZ|ER| 
1 1 1 1 IRQI 


jLoj j 

|C-| I 
|TO| | 


(2)17JSUBTYPE j 


DEV. 


TYPE j LCN 




(3)20| 


TRANSFER LENGTH 




(U) 21 | LAST 


RECOVERABLE ERROR | ERROR CODE 




(5)22| 


WAIT QUEUE 







ACTV^ACTIVE 

INT-AC=INTERRUPT 
ACKNOWLEDGE 

DRV-EN=DRIVER 

1 ENTERED 

2 
3 
k 

5 

TO=TIMEOUT 
6 LOC=LOCAL 

7 
8 

9 

10 
11 
12 

13(0) MASK 

lU(l) FLAG 

15(2) LINE INFO 

16(3) 

17(U) 

18(5) 
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CS DIT (CONT. ) 



(6)23 


|IN|IN|TR|IN|SPEED| CS | CS | 
H-|H-|C-|H-|SELEC| MODE 1 CODE | 
T0|ID|SP|CL| | | | 






(7)2U 


1 | |DIAL | IN | CO | 

PROTOCOL | JTYPE |H-|N-| 

1 1 |BF|IO| 


(10)25 


[ 1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15) 
|RE|NO|DS|END |LD|AS|DB|DB|EX|MFW |CH|NUM | 
|M-|-R|B-|SEQN |-G|-B|WK|T |-I|TYPE |A-|SYNCS| 
|WT|VI|CT| |PH|CC| |TD|TB| |WR| | 


(11)26 


I CO[ |AB|DU|HA|XMSN |SP| 

|DE| |T-|AL|LF| |D-| | 

|SN| HSI CEAN |AK|SP|SP|MODE |CH| | 


(12)27 


Iiol I 

|PR| CS MISC DSTN | 
|ES| | 


(13)30 


RECEIVE TIMEOUT | 


(1*031 


LOCAL TIMEOUT j 


(15)32 


CONNECT TIMEOUT | 


(16)33 
(17)3U 


INSPEED CHRS/SEC 1 


(20)35 
(21)36 


OUTSPEED CHRS/SEC j 


(22)37 


1 2 3 *+ 5 6 7 8 9 10 11 12 13 lU 15) 
RE|RE|TR|TR|IN|DI|ID|ID|ID|1 |2 |MS| AB|FI | PA| AB| 
QU|CV|CO|PD|HN|RT|BI|FR|ER|ST|ND|TA|TL|ND|DA|PO| 
SD|ER|MP|RV|DL|BF|TS|ZN|R j IN | IN j TR j AT | ID j DD j LL j 


(23)1*0 


MISC ARRAY | 


(2U)Ul! 

(25)1+2 


TIME 1 

(CHRONOS TIME OF LAST | 

CONNECTION) (CALENDAR&CLOCK) j 


(25)U3 


# MESSAGE SENT | 



19(6) COPTIONS 



20(7) AOPTIONS 

21(8) DOPTIONS 

MISC 
22(9) 

DSTINFO 
23(10) 

2U(11) 
25(12) 
26(13) 
27(lU) 
28(15) 
29(16) 
30(17) 

31(18) FLAGS 
32(19) 

33(20) 

3M21) 

35(22) 
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CS DIT (CONT.) 



(27)V»| 
I 

(3Q)U5! 
I 

(3DU6I 



# MESSAGES RECV'D 



(32)U7| 



I 



RECOVERABLE ERRORS 

(33)50 | IRRECOVERABLE ERRORS 

I 

(3*051 I COMPLETION CODE | TIMEOUT CODE 
| _ 

(35)52 | LOCAL TRLX TIMEOUT 



(36)531 



(1 2 



TIMEOUT TRLX 
8 



|TR|TR| |TR| 

(37)5*+|AL|WR| TRACE MASK |DR| 



I 



(l+0)55i 

i 

(1+1)561 
I 

(1+2)571 
I 



TRACE ENTRY NUM 
CURRENT RETRYS 



(1*3)60! 



MAX ENTRYS | 
LINE STATE | 

XMSN LOG 
CTS DELAY | PREEMP ERROR 



i __. 



(kk)6l\ 
I- 

<U5)62| 
I- 

(1+9)631 

(l+7)61+| 

I- 
(50)651 
I 

I 
(52)671 

I 

b3)f0j 

I 

(5^)7H 
I 

(55)72| 
I 



CNTRLSEQ 



TIMEOUT 
VALUE 



OUTPUT BUFFER BANK 
OUTPUT BUFFER 
OUTPUT BUFFER LENGTH 



lWfur Burr jsk banjb. 

INPUT BUFFER 

INPUT BUFFER LENGTH 



(0 12 
|TR|TR|TR| 
(56)73|CE|CC|CF| 



6 7 8 

| IN |DS | RESPONSE 
|& |R J TIMEOUT 



36(23) 
37 {2k) 
38(25) 



39(26) 




1+0(27) 




Ul(28) 




H2(29) 




1+3(30) 




TRWR=TRACEWRAP 


TRAL=TRACE ALL 


1+1+(31)TRDR=TRACE 




DRIVER 


1*5(32) 




1+6(33) 




1+7(31+) 




1+8(35) 




1+9(36) 


DRIVER 


50(37) 


PARM1 


5K38) 


DRIVER 


52(39) 


PARM2 


53(1+0) 


DRIVER 






55(U2) 


DRIVER 






57(1+1+) 


DRIVER 


58(1+5) 


PARM 5 



) 



5U(U6) 
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I RR I OM I LH I | PL | DL | | 

I I 

(57)7U| BID TIMEOUT |60(1»7) 
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CS DIT (CONT.) 












1 

'0 ' 

(6o)75|po| 

|LC| 
|HG| 

(6l)76| 


1 
1 
1 


BLOCK SIZE 
SEND MFW 


! 

61 (U8) 
62(U9) 


(62)771 




AGGREGATE XLOG 


63(50) 


( 
(63)100 | REQ STATION 


18 

| CURRENT STATION 


6M5D 


(61+)101| # POLL 


ENTRIES | POLL LIST INDEX 


65(52) 


(65)1021 




TRACE IOQ 


66(53) 


(66)1031 




POLL ENTRY DELAY 


67(5*0 


(67)10U| 




POLL REPEAT 


68(55) 


(70)1051 




POLL LOOP DELAY 


69(56) 


(71)106 | 




CONFIG BUFFER SIZE 


70(57) 


(72)1071 




REQUEST IOQ 


71(58) 


(73)110| 




HARD ABORT IOQ 


72(5*0 


(7^)1111 
(75)H2| 


----- 


SOFT ABORT IOQ 
RETRANSMISSIONS 


73(60) 
7U(6l) 


(76)1131 




# RESPONSE TIMEOUTS 


75(62) 


(77)llU| 




# BCC ERRORS 


76(63) 


100)1151 




# RECV TIMEOUTS 


77(6U) 


101) 116 j 




# OVERRUNS 


78(65) 


102)1171 




PREVIOUS RECOV ERROR 


79(66) 


103)120 j 




BUF 1 BYTES LEFT 


80(67) 


10l|)121| 




BUF 2 BYTES RIGHT 


81(68) 


105)122| 




RECV MFW 


82(69) 
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CS DIT (CONT.) 



LINE CONTROL MONITOR (LCM) 
SECTION OF THE DIT 



12 3 


6 7 8 10 11 12 


RC|SE|RE|RE| 
AK|AK|SP|SP| 
CT|CT|TO|FG| 


|SD|RD|RD| |DW|SV|TE| 
| WA J RE | IN | |N |AB|XT| 
|CK|PT|TR| J LD j RT J | 


USER REQUEST 


CURRENT STATE 


TRACE STATE 


MRJE BUF 



MRJE BUF 1 
MRJE BUF 2 



LCM BUFFER (8 words) 



EDITOR SECTION 

OF THE DIT 
(DRIVER DEFINED) 



PHYSICAL DRIVER 

SECTION OF THE DIT 

(DRIVER DEFINED) 



LCMP(O) LCMPFLAGS 

LCMP(l) 

LCMP(2) 

LCMP(3) 

LCMP(U) 

LCMP(5) 

LCMP(6) 

LCMP(7)-LCMP(lU) 
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CS DIT (CONT.) 



CS DIT FIELDS AND DEFINITIONS 



MASK and FLAG 
Words 13 and lU 



CMP - IN 
PWR-FL 
HD-ABT 
SF-ABT 
TO 

BF FZ 
ID FZ 
USER RQ 
LOC-TO 



Completion Interr 



■ *=* - - ■">*' w 



Power Fail 
Hard Abort 
Soft Abort 
Timeout 
Buffer Frozen 
ID Frozen 
User Request 
Local Timeout 



COPTIONS 
Word 19 



INH-TO 
INH-ID 
TRC-SP 
INH-CL 



Inhibit Timeout 
Inhibit ID 
CS Trace 
Inhibit :CLINE 



AOPTIONS 
Word 20 



INH-BF 
CON- 10 



Inhibit Buffering Override 
Concurrent 10 



DOFTIONS 
Word 21 



MISC 
Word 22 



REM-WT 

NO-RVI 

DSB-CT 

END-SEQN 

LD-GPH 

AS-BCC 

DB WK 

DB-TTD 

EX ITB 

MWF TYPE 

CHA-WR 

NUM-SYNCS 



CODE SN 
ABT-AK 
DUAL SP 
HALF SP 
XMSN MODE 
SPD-CH 



Delay Sequence Wait 

Poll Termination Sequence 

Disable Control Read 

Ending Sequence 

Leading Graphics 

Value of US ASCII BCC 

Disable WACK 

Disable TTD 

Expect ITB 

Message Format Word 

Chain Writes 

Number of Leading SYNCS 



Code Sensing 
Abort ACK 
Dual Speed 
Half Speed 
Transmission Mode 
Speed Changeable 
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CS DIT (CONT.) 



DST INFO 
Word 23 



ID PRES 



ID Present 



FLAGS 
Word 31 



REQ USD 
RECV ER 
TR COMP 
TR PDRV 
IN HNDL 
DIRT BF 
ID BITS 
ID FRZN 
ID ERR 
1ST IN 
2ND IN 
MSTA TR 
ABT LAT 
FIND ID 
PAD ADD 
AB POLL 



Request Used 

Recoverable Error 

Trace Out Completion 

Trace Out Physical Driver 

Interrupt Handler 

Dirty Buffer 

ID Frozen Bits 

ID Frozen 

ID MAM Error 

First Interrupt 

Second Interupt 

MMSTAT Trace 

Abort Later 

Find Station ID 

Pad Added 

Abort Poll 



STANDARD (U6) 
Word 5U 



TRC ERR 
TRC COM 
TRC FLH 
IN & PL 
DSR DL 



Trace Error Toggle 
Trace Complete 
Trace Flush 
Increment and Poll 
Date Set Ready Delay 



LCMFLAGS 
LCMP(O) 



RC AKCT 
SE AK CT 
RESP TO 
RESP FG 
SD WACK 
RD REPT 
RD INTR 
DWN LD 
SV ABRT 
TEXT 



Received ACK Counter 

Send ACK Counter 

Response Timeout 

Response Flag 

Send WACK 

Read Repeat 

Read Interrupt 

Download 

Save Abort 

Text 
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TERMINAL TABLES 



TERMINAL IOQ ELEMENT 



1 2 3 b 5 6 7 8 9 10 11 12 13 1U 15 



i i i i _ i ■ i ■ 

■ — ■ — ■ — i — i — i — i — i 



■I--I- 



i - i ■ 



I-!- 1 "' 



ii 



REQUEST DEPENDENT FLAGS 



1 




NEXT IOQP 


2 




UNIT # | LOGICAL DEVICE NUMB. 




FL| 


IREADSTOP | REQUEST STATE 


51 


SF| 


DATA SEGMENT NUMBER 
TARGET ADDRESS OFFSET 


6! 




| FUNCTION CODE 


71 




C0UNT/XLOG/C0NTR0L RETURNS 


%10| 




PARAMETER 1 (FUNCTION DEPENDENT) 


%lll 




PARAMETER 2 (FUNCTION DEPENDENT) 


%12\ 

\ 




| QUALIFYING | GENERAL 
PCBN | STATUS | STATUS 



BITO ABORT 

BIT1 SPECIAL 

BIT2 DIAGNOSTIC 

BIT3 SYS BUFFER 

BIT1+ 10 WAKE 

BIT5 BLOCKED 

BIT6 COMPLETED 

BIT7 DATA FREEZE 

BITS MAM ERROR 

BIT9 

BIT10-12 READ ERRORS 

BIT13-15 RPLEVEL 



QFLAG 
QLINK 
QLDEV 
QMISC 
QDSTN 
QADDR 
QFUNC 
QWBCT 
QPAR1 
QPAR2 

QSTAT 
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TERMINAL IOQ FIELDS AND DEFINITIONS 



QFLAG - Flags and request state. 



ABORT Abort this request and return an error indication to 
the caller. 

SPECIAL Special handling is to be applied to this request. Has 
no meaning for terminal requests. 

DIAGNOSTIC This is a request from a diagnostic subsystem. Not used 
by terminal system. 

SYSBUFRS Target is an index relative to the SBUF table of the 
data buffer. 

IOWAKE Wake caller on completion of request. 

BLOCKED Blocked I/O. The caller is waited in ATTACHIO until the 
request is completed. Implies wake. 

COMPLETED Request has been completed and caller woken if requested. 

DATAFRZN If set then the data segment has been frozen in memory. 
Set by MAM when a MAKEPRESENT request is successfully 
completed . 

MAMERRD An error has occurred in trying to make the target data 
segment present and freeze it in core. 

READERRORS This field contains a code specifying the resulting 
status on a read termination. 

- no error 

1 - read terminated on special read termination 

character 

2 - read completed because break was enabled and 

detected and allowed. 

3 - read data lost because of no TBUFS available, 

PTAPE swing buffer write not completed in time 
or term=ll and char following DC 2 was not a CR. 
k - character lost because interrupt not service 
before next character was input 

5 - read parity error occurred and parity checking 

enabled 

6 - read timed out 

7 - block mode read timed out 
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TERMINAL IOQ (CONT.) 



RPLEVEL Request preempt level. If the preempt type of the request 
was zero then this is the value of TMODE when the 
request was queued, otherwise it is the preempt type of 
the request. 
- terminal in normal mode and non preemptive request 

2 - normal request, terminal was in console mode when 

the request was queued 

3 - soft preemptive, preempt reads with no data input 

U - hard preemptive, preempt all non preemptive requests 



QLINK - SYSDB relative pointer to the next IOQ element, 
first word of the next element. 



Points to the 



QLDEV - Logical device number. 
QLDEVN Logical device number 

QMISC - Request state and flags 

FLUSH (FL) This flag is set when a control Y is detected and 

accepted while this request was waiting or being pro- 
cessed. Causes reads and writes to be successfully 
completed, although no I/O takes place. 

READSTOP Stop read operation if not zero. 

- null or no stop 

1 - break has been detected and is allowed 

2 - subsystem break has been detected and is allowed 

3 - request has been prempted 

k - read operation has been timed out 

5 - request has been aborted 

6 - block mode read has timed out 

NOTE: BIT 10 is NO STOP bit suppresses aborts and prompts 

RSTATE Request state. Any codes not described below are unused. 





1 



2 - 

%hl - 

%kk - 



%30 



Request not started or new. 

Request has been started. Reads or writes may be 

waiting for the current write to finish to be 

continued. 

A read operation is in progress. 

A read operation has been completed but the data 

has not been transferred to the callers buffer. 

A read operation has been stopped. The cause and 

corresponding action to be taken is identified 

by the STOPREAD field in QMISC. 

Read initiation conditions have been checked and 

the read can be started as soon as the current 

operation (usually a write) is completed. 

Waiting (because 270 bytes tanked or no TBUFs) 

to enter a CRLF because a post space write follows 

a previous prespace write. 
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TERMINAL IOQ (CONT. ) 



7.31 - Waiting (because 270 bytes tanked or no TBUFs) to 

enter prespace carriage control bytes. 
%32 - Waiting (because 270 bytes tanked or no TBUFs9 to 

enter callers data into terminal buffers. 
%33 - Waiting (because 270 bytes tanked or no TBUFs) to 

enter post space carriage control bytes. 
%3U - %37 Correspond to states &30 - %33 but waiting to 
enter an ENQ for the 26k0/kk. When the ENQ 
has been entered into the TBUF, the state 
reverts to the current state -U. 
STACKFLAG(SF) If the QADDR is the offset from DB to target 

address, otherwise QADDR is offset from DST base. 
QDSTN - Contains the data segment number of the target data area. 

QADDR - Offset to the target data area in the data segment or bank. 
For PTAPE reads, this word contains an SBUF index to the 
first of a pair of SBUFs used to read the data into. 

QFUNC - Function code. See ATTACHIO description for details. 



FUNC 



Function code field. 

- read 

1 - write 

2 - file open 

3 - file close 

k - device close 

5 - set timeout 

6 - set inspeed 

7 - set outspeed 
%10 - echo on 

%11 - echo off 

J112 - disable break 

%13 - enable break 

%lU - disable escape 

%15 - enable escape 

%l6 - disable tapemode 

%17 - enable tapemode 

%20 - disable timer 

%21 - enable timer 

%22 - read timer 

%23 - disable parity 



%2k - enable parity 

%25 - logged on 

%26 - set parity 

%27 - set terminal type 

%30 - allocate terminal 

%31 - clear flush and write 

%32 - enable control X ! ! ! echo 

%33 - disable control XI!! echo 

%3k - not used 

%35 - PTAPE read 

%36 - set/reset break mode 

%3J - set/reset console mode 

%k0 - set parity 

%kl - allocate terminal 

%k2 - set terminal type 

%k3 - return terminal type 

%hk - return outspeed 

%U5 - set stop characters 

%U6 - change console interrupt 

%kj - speed sense 

%50 - powerfail recovery 



QWBCT - Word or byte count and control returns. On initiation specifies 
a word count if positive or a byte count if negative. At 
completion of the request this location contains the actual 
transmission count in the same units as the call specified. 
Certain control requests return information through this 
location. 
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TERMINAL IOQ (CONT.) 



QPAR1 - Parameter one. See first page of driver listing for details. 



QPAR2 - Parameter two. See first page of driver listing for details. 



NOTE: During PTAPE reads, QPAR1 and QPAR2 contain a double 
word disc base address of the virtual memory area 
where the spooled data is saved temporarily. 



QSTAT - Request completion status and PCB number associated with this 
request . 



PCBN PCB number associated with request. If zero this IOQ 
element is returned by the system when the request is 
completed . 

QUALIFIER A code which further defines or qualifies the general 
status. See ATTACHIO description for details. 

STATUS General status. Indicates the current or resultant 

status of the request accorddng to the following codes, 

- not started or awaiting completion 

1 - successfully completed 

2 - end of file detected 

3 - unusual condition 

U - irrecoverable error 
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DIT for ATC/SERIES 11,111 



1 
2 

3 
It 

5 
6 

7 
%10 
11 
12 
13 
Ik 
15 
16 

17 

%20 

21 

22 

23 
2k 



1 2 3 *+ 5 6 7 8 9 10 11 12 13 lU 15 
DFLAG FOR A READ: 
TRM|UP |ACT|REQ|SIH|SPG|WWT|PR | NWL | FTY | TCH | BRD | DSTATE 



DFLAG FOR A WRITE: 
TRM|UP |ACT|REQ|SIH| |WWT| 1 |NWL| 



| AWT | 



DSTATE 



SYS I/O PROC NEXT DIT POINTER 



FIRST REQUEST IOQ POINTER 
FLU|NCE|NPT| UNIT | LOGICAL DEVICE # 



DLT POINTER 
ILT POINTER 



HGU|DSC|CFT|TTO|HTO| |SPE|SPW|RDT|ONL|DSY|LGO|BRK|ESC|BTO|STD 
TIM|TMR|DELECHO|FFD| TTYPE |EXS|CNP| | PAIRCODE 



PEM| MTYPE |CF |CB |SB | NSY | RCT | WCT | PMD | TMODE | LPLEVEL 
TPM|RES|SYN|ECH|SPS|ESC| | OUTSPEED |FIL|BOK| INSPEED 



| | 



UNIT |PCL|PTY| NEXT DSTATE |PSL| 1 | 
REQUESTED COUNT IN BYTES 



READ/WRITE BYTE COUNT 
WAITED STATE | HSTATE |TTW| TURN CHAR 



SUB SYS BREAK CHAR | EOR CHAR 
NEXT DITP OF BANDWIDTH WAITED DEVICE 



WRITE BYTES TANKED SO FAR / TIMEOUT LENGTH FOR BLOCK MODE READ 
BYTE COUNT OF EOF SAVED READ 



COUNT TO END OF READ/WRITE TBUF 
HEAD POINTER TO READ/WRITE TBUF's 
TAIL POINTER TO READ/WRITE TBUF's 



DLINK 

DIOQP 

DLDEV 

DDLTP 

DILTP 

DRQST 

DTYPE 

DMODE 

DSPEE 

DCNTR 

| DRBC 

DBCNT 

DSAVE 

DSTOP 

DWAIT 

DXCNT 

DBTI 

DRCNT 

DCNT 

DHEAD 

DTAIL 
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DIT FOR ATC/SERIES II/III (CONT.) 



25 
26 

27 
fo30 
31 
32 
33 
3U 

35 
36 
37 



hi 



42 
U3 



BYTE POINTER TO NEXT READ/WRITE BYTE 
HEAD POINTER TO EOF SAVED READ TBUF's 



TERMINAL TYPE |BWR|PTY SV| |NFM| DSPEED 
POINTER TO NEXT DIT IN TBUF WAIT LIST 



POINTER TO SAVED TBUF AFTER TBUF WAIT 
READ TIME/FIRST WORD OF DOUBLE TIMERS 



2ND WORD OF DOUBLE READ START TIMER READING 
MAXIMUM READ TIME IN SECONDS 



LF SYNCS i CR SYNCS | 
IOQP TO BROKEN READ SAVED DATE 



SYNC COUNT 



26k0 /SPEED TRLX | LOGON/HANGUP/READ TRLX 
CFAIL TRLX | TURN TRLX 

LOGONTY|XOW|AEJ| CFAIL CNT | MCODE 



MMSTAT TIMING INFO 



| DPNTR 

i 

| DRPTR 

i 

| DLAST 

1 

| DTBLK 

i 

| DNXTB 

I 

| DRTIM 

I DRTI 

I 

I 

| DRTMA 

I 

| DSYNC 

I 

| DBREA 

! 

| DTRLX 

I 

| DDSET 

I 

| DMONI 

I 

I 
1 
| DMMTI 

I 



|RQS| ESCSEQCNT | DMISC 
1 
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ATC/SERIES II, III FIELDS AND DEFINITIONS 



DFLAG - FLAGS AND DEVICE STATE 



TERMINAL 
UP 

ACTIVE 

REQUEST 

SPECIH 

SPOOLING 

WRTWAIT 

PAIR 



NEWLINE 



PTYCHK/ 

26U5K 

FLAG 

TERMCHAR 



Device is a terminal 

If set, device is on line, has been speed sensed or 
has been initialized and can do I/O. If clear then 
in speed sense mode. 

If set, monitor is currently active servicing this 
device . 

Service for this device was requested while the 
monitor was active. 

Use special interrupt handler. 

Input has been requested through the PTAPE procedure. 

A character or sync is in the process of being output 
and a completion interrupt is expected. 

Pair is set whenever no read is in progress or when 
the action on the next character is dependent on the 
previous character input or the previous state. See 
paircode for details on the various pair conditions. 

A linefeed was the last character input or output. 
Used to determine if a CR/LF is necessary on mode 
changes or at FOPEN time. 

Read data is to be checked for correct parity, and if 
incorrect a parity error indication is to be returned to 
the caller. 

A special read termination character has been specified. 

The read data is to be checked and if the termination 

character is found the read will 

be terminated and the character set in the buffer. 

If the binaryread bit is set then this bit indicates a 

"transparent" read is in progress with sub system break 

and EOR characters in DSTOP. Both a termchar and a 

transparent read may be in progress simultanously if 

the termchar field of QPAR2 is not zero. 
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DIT for ATC/SERIES II, III (CONT.) 



BINARYREAD A binary or transparent read was specified. If TERMCHAR 
is clear then a binary read is in progress. All 8 bits 
are transferred and no editing takes place. A binary 
read is teminated only when the count is satisfied. If 
termchar is set, then a transparent read is in progress. 
No editing takes place but only 7 bits are transferred. 
An EOR and sub system break character are held in DSTOP. 

ACKWAIT An ENQ was sent to a 26k0/kk. Waiting for an ack or 

time out before continuing the write. Has this meaning 
during write operations only. 

DSTATE Device state. Specifies the current device activity 
and is used to detemine the next state. 

- null or no activity. 

1 - writing. 

2 - reading. 

3 - XON write, reading next. 

U - turning 202 modem to write state, next state in 
NXTD STATE. 

wait for less terminal activity to start read/write 
end of record (EOR) LF in progress, null state next. 
EOR CR in progress, EOR CR state next. 



5 

6 

7 

%10 

%11 



%12 - 

#L3 " 

%lk - 

*L5 " 
*16 - 

%n - 



EOR sync in progress, EOR CR state next, 

write being waited for a break allowed check by 

term. 

delete LF or delete echo character being written 

or start read next. Send XON to start read next. 

delete CR being written, delete LF state next. 

"!!!" or syncs being written. Next state is delete 

CR or saved in WAITEDSTATE if sync set. 

1st character of a termtype 11 read is being echoed. 

have TIP start a read operation. 

finish up read then do DSTATE operation held in 

NXTDSTATE . 



DLINK - Link word for linked list of the devices waiting for service 

by the system 10 process. If not zero or -1 (end of list) 

then a DIT pointer to the next device waiting. 

DIOQP - SYSDB relative pointer to the first IOQ element in the request 
list for this device. 

DLDEV - Logical device number and unit number. 



FLUSH 



This flag is set whenever a break has been detected and 
accepted. While it is set, writes are returned completed 
without any I/O being done. Reads are returned with an 
unusual condition status, f«173- 

It also holds off any further break service requests. 
It is reset with a function code 25 operation. 
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NO'CX'ECHO if set, then "!!!" is not to be echoed when a control 
X is detected to delete a line. 

.NO PTY Terratype is 8 bit in nature. (no pty set or check allowed) 

UNIT unit number of device. 

LDEVN Logical device number. 

DDLTP - SYSDB relative pointer to driver linkage table (DLT). 

DILTP - SYSDB relative pointer to interrupt linkage table (ILT). 

DRQST - Monitor service request flags. The requests are serviced in 

a left to right order. The bit position determines the 

priority with which the request is serviced. 

HANGUPTO Hangup timeout has been completed. 

DISCNCT Dataset has disconnected (dataset ready has dropped) . 

CFAILTO Timeout started when carrier failed has completed. If 
103 then hangup else try to turn 202 around again. 

TURNTO CB or SB is not true 5 seconds after starting the read 
to write turnaround on the 202. Hangup device. 

HP26U0T0 An ACKWAIT from an ENQ to 26h0/kk has timed out. The 
ACKWAIT is terminated and the write restarted. 

SP00LEND A control Y has been detected terminating PTAPE input. 

SPO0LSW Switch PTAPE input buffers. 

READTO A read operation has been timed out. 

ONLINE A colon has been input and the device speed sensed. If 
not connected through a dataset, initiate a log on time 
out. 

DSETRDY Dataset ready has been detected. Initiate a log on 
time out. 

L0G0NT0 A log on time out has occurred. The caller has not 
logged on. The device is hungup. 

BRK A break has been detected or SB has dropped while writing. 
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ESC A control Y has been detected. 

BLOCK TO Block mode read has timed out before completion. Read is 
returned with 10 timeout code. 

STAT DONE Logical write and associated status request have been 
completed for 2631B. 



DTYPE - Terminal type and other flags. 



TIMING 



TIMEREAD 



DELECHO 



FORMFEED 



A request to measure the time taken to complete a read 
operation has occurred and the time at the initiation of 
the read has been saved in DRTIMED. When the read is 
completed, the time taken will be saved in DRTIME. 

The time required to complete a read operation is to be 
monitored and saved in DRTIME. 

This field contains a code which specifies the character 
to be output when a delete character (control H) is 
input. Different characters are output if the word 
count is zero to keep the carriage at the proper place. 

CODE INPUToO INPUT=0 COMMENT 

nothing space terminal backspaces 

1 "/" nothing hard copy no backspace 

2 line feed space hard copy backspaces 

3 control Y nothing 2600 control Y backspaces 

If set then a form feed is output when the form feed 
character {%lk) is to be output. If clear a LF is 
output in place of the form feed character. In either 
case, the character is preceeded by an XOFF and carriage 
return. Usually clear for terminals which do not 
respond to a form feed. 



TTYPE 



terminal type as specified 



- ASR 33 

1 - ASR 35 

2 - ASR 37 

3 - execuport 
k - datapoint 



9 

10 
11 
12 
13 



5 - Memorex 

6 - terminet 15 

7 - 27U1 call 360 16 

8 - 27Ul PTTC /EBCDIC 18 

19 
20 
21 
22 



in the MPE ERS. 

mini bee (HP2615) 

HP26U0.AU 

HP26U0/UU & auto enter cap 

HP26U5K Katakana/Roman data 

term connected to packet 

switch inc 

network or other computer 

HP2635A print term (8 bit) 

HP2635A print term (7 bit) 

Generic CRT 

HP2631B (7 bit) 

HP2631B (8 bit) 

HP2631B (7 bit) 

HP2631B (8 bit) 
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ETXSENT End of Text (ETX) character has been sent to 
a 26itOX on a 202 to stop the terminal from 
listening. Carrier may now be dropped. 

CONSTRNTRPT. (11:1) If set then Control A on the Console will 
cause PROGEN to be awoken. If clear, then 
Control A is ignored. 

PAIRCODE when the action to be taken on the next character is 

dependant on the previous state or character input then 
this field contains a code specifying the previous 
character or condition. 

- no read in progress 

1 - XOFFPAIR. Last character input was an XOFF during 

a tapemode read on a terminet. EOR has been 
returned and if the next char is a CR then ignore 
it. 

2 - DELETEPAIR. A LF was echoed on a char delete. No 

LF echo is needed if next char is a control H. 

3 - ESCPAIR. Last character was an escape. Check next 

character for an escape sequence. 
1» - NODATAYET. A "NONSYNC" terminal read has been 
started with echo on but no data has been input 
yet. If the first character is a DC2 then paircode 
is set to enter (the DC2 is not saved) othewise 
process as a regular character. 

5 - N0ECH0. A termtype 11 read has been started with 

echo off. If first char is a DC2 then set paircode 
to enter (1st char not saved) otherwise write 
character . 

6 - CRWAIT. A 26k0/kk block mode read has 

been satisfied and stopped and waiting for a CR to 
complete the read. No Control X checks are made to 
restart read. 

7 - CRWAITLF. Same as CRWAIT but an LF is to be echoed 

if requested after the CR is detected. 
Continue read with echo on. 

8 - ENTER. First character of a noecho read was a 

DC2. If next character not a CR then set Data Lost 

status, else set PRIMED and if Reading then restart 
read to input data. 

9 - DC2PAIR. Last character read was a DC2 from 

a 26kQ/kk. If the next character is a CR then set 
primed, delete all data input and restart read. 

DMODEM - Modem state and control flags 



PREMPT When set indicates that at least one request is 

preemptive. In this case a scan of the request list is 
made to determine which request should be processed 
first and if the current request is to be stopped. 
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MTYFE 



Modem Type 
- hardwired 2 - 202S 
i - 103 3 - 2002 

U-7 -- Same as 0-3 except no speed sensing is done. 



CF 



CB 



SB 



Carrier detected status from dataset. 



Clear to send status from dataset. 
delayed. 



Request to send 



NOSYNC 



RBCOUNTEB 



Secondary receive status. Senders CB when writing. 

If set specifies that no delays are used by this teminal. 
Instead an ENQ is sent after 80 characters and the write 
doesn't continue until an ACK is received or a timeout 
occurs. Set for 26U0/UU terminals. 

When set, indicates the "number of terminals doing block 
mode reads counter" has been incremented and when this 
operation completes the counter is to be decremented. 



WRTCOUNTED When set, indicates that the "number of terminals doing 

writes" has been incremented and when this unit completes 
its operation the counter is to be decremented. 



PRIMED 



TMODE 



When set indicates an "ESC D" sequence has been written 
or a DC2 has been received by a NOSYNC terminal. Before 
any read operation is initiated to a primed terminal to 

do a block mode read, the number of terminals doing I/O 
must be less than 13. If it is greater then a request to 
start the read is queued. 

Terminal Mode. 

- normal 

1 - break mode 

2 - console mode 

3 - console mode and return to break mode 

Preempt level of last request. If preempt level of new 
request is higher then generate a CR/LF. 

- normal request 

1 - Not Used 

2 - normal request with terminal in console mode 

3 - soft prempt (preempt reads with no input yet) 
U - hard preempt (preempt all requests) 



DSPEED - Multiplexor speed and other flags, 



LPLEVEL 



TAPEMODE Input from paper tape. No characters are emitted in 
response to delete commands or at end of record. 
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RESTART If set indicates that a write completion interrupt has 
occurred while the terminal buffers were being filled. 
The filling procedure restarts the write by issuing a 
SYNC. During a read if this bit is set, the read is to 
be restarted when a CR is detected because a control X 
deleting the line was detected. 
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SYNC 



ECHO 



If set and DSTATE=Repeating then SCOUNT contains the 
number of SYNC characters to be output after the 
completion of the current operation. If clear and DSTATE 
=Repeating, then SCOUNT contains the number of "!" 
remaining to be output in response to a Control X. 

If set specifies that characters read during input are 
to be echoed if the device is operating full duplex. 



SPDSENSING If set indicates that the device is in the speed sensing 
mode. When in the speed sensing mode a control has been 
sent to the multiplexor connecting the main channel to 
the diagnostic channels. 



ESC 



Control Y breaks have been enabled through an FCONTROL 
call. 



OUTSPEED A code used to determine the baud rate and character 
size of the data output. 

- 2U0 CPS or not determined 

1 - 2U0 characters per second (CPS) 

2 - 120 CPS 
3-60 CPS 



u 


- 30 CPS 


5 


- 15 CPS 


6 


- 10 CPS 


7 


- Ik CPS 



FILLING 



BRKOK 



Set when IOTERMO is putting data into TBUFS. If the last 
TBUF is to be returned by TIP when this flag is set then 
the write is waited and DCNT is set to -2 by TIP to 
indicate TIP is waiting. 

If set then break is allowed otherwise break is ignored. 
Set and cleared through FCONTROL calls. 



INSPEED A code used to determine the baud rate and character 

size to be used to input data. The codes have the same 
meaning as those specified in outspeed above. 

DCNTRL - This is a control word output to the multiplexor board to 



send control and data to the particular channel, 
contains other information in the unused areas. 



It also 



PCL 



PARITY 



Parity Control bit. If set, parity is enabled, 
it is zero, parity is disabled. 



If 



This bit is ORED into the eighth bit position on all 
characters output. If the eighth bit is zero it 
represents the parity of the character output if the 
parity control option is selected, otherwise it 
represents the sense of the eighth bit output. Also 
represents the parity expected during a read. Set when 
speed sensed or by function 21. 
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NXTDSTATE This is the next DSTATE to be set after a 202 modem 

turnaround is completed. Also contains the next V DSTATE 
after a FINISHREAD (DSTATE=%17) operation is completed. 

PRESPLAST If set then the last write operation was a PRESPACE. 

If next write is a postspace and newline is not set then 
a CR/LF is output to clean up the carriage. 



DRBCT - For read and write request, this word holds the requested 
transfer count in bytes. 

DBCNT - During reads this word contains the number of characters input. 



During writes it contains the number of characters remaining 
to be written, including any already written from the current 
TBUF. 



DSAVE - Holds next DSTATE after waiting and repeating DSTATEs and 



also the next byte to be output after a 202 turnaround is 
completed. 



WAITEDS Holds the current DSTATE when a break is detected and 
an operation is suspended in order that term may check 
that break is allowed. It also holds the next DSTATE 
after "SYNC's" are output in the repeating DSTATE. 

HSTATE Hangup state. 

- null or hungup 

1 - on line or normal operating condition 

2 - log on time out in progress 

3 & 5 " INITWAIT. speed sense failed, disconnected speed 
k - DCLOSE issued, disconnect next. 

6 - hangup turn to read is in progress, the 202 dataset 

needed to be put in read state before hanging up. 

7 - hang up settling timeout is in progress. 

sensing delay, then reinitialize channel. 

TURNTOWRT If DSTATE is TURN202, then if set indicates a turn to 
write else the turn is a turn to read. 

TURNCHAR Holds the character to be output after the 202 is 
turned around from read to write. 

DSTOP - Holds the subsystem break and end of record characters if not 



zero indicating no editing is to be applied to a read. If 
not zero then no editing is to be applied to the characters 
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input except for the following characters. 

BREAKCHAR Detection of this character causes the same action as 
the detection of control Y for a normal read. 

EORCHAR Detection of this character terminates input, if the 
device is in tapemode or 26UX doing block mode input, 
the read is not terminated until a CR is detected. 

DWAIT - Link word for a liked list of the devices waiting to be 



started when the terminal activity decreases. If not zero 
then a DIT pointer of the next device waiting. If -1 then 
signifies that this device is the last one in the list. 



DXCNT - Holds the number of bytes transferred so far to the TBUFs 



during a spacing or user's data transfer operation. Used to 
restart the TBUF fill operation after a wait because more 
than 270 bytes have already been tanked. (Valid for write.) 

DBTIHE- Contains the timeout length for block mode read. (Valid for 

read. This is the same word of the DIT as DXCNT.) 



DRCNT - When read data has been saved because an EOF was returned 
this word contains the byte count of the saved data. 



DCNT - During a write, this word contains the number of characters 

remaining to be written from the current TBUF. During a read 
it contains the number of characters remianing to fill the 
current TBUF or to satisfy the read count. Set to -2 to 
indicate a write completed during a fill operation. When -1 
then new TBUF need to get next byte from. 

DHEAD - A SYSDB relative pointer to the current TBUF being written 
from or the first TBUF of a linked list during a read. 



DTAIL - A SYSDB relative pointer to the current TBUi? being read 
into or the last TBUF of a linked list during a write. 



DPNTR - A SYSDB relative byte index to the last byte written or 
to last byte read. During a read if a new buffer is to be 

gotten to save the current byte input then this pointer is 

set to -1. 
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DRPTR - When not zero, this word points to a linked list of TBUFs 

which contain the data saved from a read which returned an 

EOF requesting the read to be saved. 



DLAST - Holds the default terminal type, parity save data and 
preconfigured speed code. 

TERMT Default terminal type. The terminal is set to this type 
when it is speed sensed. 

BWRITE If set the last write was in binary mode and PTYSAVE 
contains the original parity control and sense bits. 

PTYSAVE Holds the PTYCNTRL and parity bits during a binary write 
when parity generation is disabled and the parity sense 
is set to zero. 

NEWFORM Last carriage control was a form feed. 

DSPEED Preconfigured default speed code. See OUTSPEED 
for definition. 



DTBLK - Link word for a linked list of the devices waiting for a TBUF 

to be available. If not zero or -1 (end of list) then a DITP 

pointer of the next device waiting. 



DNXTB - Holds the pointer to a TBUF allocated to a device which has 
been waiting. Used to insure that a waiting device gets at 

least one TBUF when it comes to the top of the TBUF waiting 

list. 



DRTIHE- During a times read, this is the reading of the timer at 

the initiation of the read. After a timed read is completed, 

the time in 1/100 of a second is saved in DRTIME as a 

single word. If it is -1 then the time was greater than 32K. 

DRTMAX- When a read operation time out is requested, this quantity 

represents the maximum time in seconds allowed for the read 

to be completed. 



DSYNC - CR and LF SYNC counts and the current SYNC count 



LFSYNC Contains the number of SYNCs to be issued after a carriage 
return is output. If >7, then actual count will be (N-6)*5 
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CRSYNC Contains the number of SYNCs to be issued after a 

carriage return is output. If >7, then actual count will 

SCOUNT SYNC COUNTER. Represents the number of SYNCs remaining 
to be issued after the current SYNC character is com- 
pleted. This field also holds the number of "S"'s re- 
maining to be echoed after a control X is input. 

NOTE - Holds 80 minus the number of characters written since the 
last read or ENQ for 26U0/UU terminals. When this count 
goes to zero, an ENQ is inserted in the write stream. 



DBREAK- On broken reads, this word holds a pointer to an IOQ 

element which contains the count, head, tail and DPNTR 

pointers used to restart the broken read. 

DTRLX - Holds read and data set time out request indexes. 



26*t0TRLX holds the timer request index for 26U0/UU block mode 
reads and ENQ/ACK time outs. 

READTRLX holds logon, hangup and read time out request indexes. 



DDSET - Holds the TRLX indexes for the timeouts associated with the 
data set control operations. 

CFAILTRLX Holds the TRLX index to time out loss of carrier detect 
TURNTRLX Holds the TRLX index to time out turn the 202 to write 



.LOGONTYPE- indicates type of logon type to this terminal 
0= :DATA 
1= :J0B 
2= : HELLO 
.XONWAIT - XOFF has been received during write, waiting for XON 
to continue. This bit is set when a write is paused 
by a CONTROL S. 
.AUTOEJECT- 263IB will skip over perforations. 
.CFAILCNT - carrier fail detect count 
.MCODE - Monitor function and control code. 
. (13:5) - Function 

- Null or no monitoring 

1 - Call help 

2 - Monitor activity 

3 - Form Delta time histogram 

7 - Monitor calls/counts/initiations 
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.(10:1) - Apply above to DSET1,DSET2 and DSETCONTROL 
.(11:1) - Apply above to TIP 
.(12:1) - Apply above to TERM 

DMMTIM - 2 words used for timing statistics 

DMISC - miscellaneous bit fields: 



.REQSTAT - requesting 2631B status 

.ESCSEQCNT- index into excape sequence for 2631B and VIEW 



During PTAPE reads, several of the DITP words are used for different 
purposes than those in a normal read. The words and their use are 
listed below. 



DBCNT - A 16 bit logical quantity representing the total number of 
characters input during this PTAPE read. 



DCNT - SYSDB relative pointer to the base of the SBUF currently 
being used to hold the data as it is input. 



DHEAD - SYSDB relative pointer to the base of the SBUF to be written 

to virtual, memory or the pointer to the buffer to be used 

when the current one is full. 
DTAIL/ 
DPNTR- Double word logical disc address to the area where the next 

SBUF is to be written in virtual memory when it is full or 

the PTAPE read is terminated. 
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TERMINAL SPEED ENCODING 

The default speed code set in the DIT will be used to initialize 
both the input and output speeds. This parameter will be used 
to determine the speed when an FCONTROL 37 (Allocate Terminal) is 
issued which does not specify a speed. 

CODE (Future rel) SPEED (Baud) CODE (SERIES II/III) 

Undefined 

1 Externally Clocked 

2 50 

3 75 

U 110 6 

5 13^-5 7 

6 150 5 

7 200 

8 300 U 

9 600 3 

10 1200 2 

11 U800 1 
13 7200 

lU 9600 

15-63 Reserved for future expansion 

The default speed code will be set in word %27 bits 10 thru 15 of the 
terminal DIT. 



|0 1 2 3 U 5 6 7 8 9 10 11 12 13 1^ 15! 

f.27 I Terminal Type |BWT|PTYSV|///|NFM| DEFAULT SPEED | 23 DLAST 

_______ _ ^ 
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1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 







TM|UP|AC|RQ|SH|SP|MA|PR|NL|PC|TC|BR| DSTATE 





1 


SYSIO PROCESS NEXT DIT POINTER 


1 DLINK 


2 


FIRST REQUEST IOQ POINTER 


2 DIOQP 


3 


FL|NE|RF|DO| SYNCSTATE| LOGICAL DEVICE # 
STAT 
REQ 


3 DLDEV 


k 


DLT POINTER 


k DDLTP 


5 


ILT POINTER 


5 DILTP 


6 


HU|DC|CF|TT|TO|AW|SW|SE|RT|OL|DR|LO|BK|SK|BT|SD 


6 DRQST 


7 


TM|TR|DLECH|FF| TTYPE |WX|CI| PAIRCODE 


7 DTYPE 


5610 


PM| MTYPE |CF|CB|SB|NS|RC|WD|PR|TMODE|LP LEVEL 


8 DMODEM 


11 


TM|RS|EO|EC|SS|SB| OUTSPEED |RT|BO| INSPEED 


9 DSPEED 


12 


HW|LL|SS|DONXTMOD|DM|PO|OP|NEXTDSTATE |PS|FL|AE 


10 DCNTRL 


13 


REQUESTED BYTE COUNT 


11 DRBCT 


Ik 


RD CHAR ALREADY INPUT/CHARS LEFT TO WRITE 


12 DBCNT 


15 


WAITEDSTATE| HSTATElTW|DA|CC|BC|PE|NOT|SR| II | CO 

LOGON 


13 DSAVE 


16 


SUBSYS BREAK CHAR | EOR CHAR 


Ik DSTOP 


17 


DITP OF NEXT DEV WAITING FOR BANDWIDTH 


15 DWAIT 


%20 


WRITE BYTES TRANSFERRED SO FAR 


16 DXCNT/DBTIME 


21 


BYTE COUNT OF EOF SAVED DATA 


17 DRCNT 


22 


READ/WRITE COUNT TO END OF CURRENT TBUF 


18 DCNT 


23 


HEAD POINTER TO READ/WRITE TBUFS 


19 DREAD 


2k 


TAIL POINTER TO READ/WRITE TBUFS 


20 DTAIL 


25 


BYTE OFFSET IN TBUF TO START CHANNEL PROGRAM 


21 DPNTR 


26 


HEAD POINTER TO EOF SAVED READ TBUFS 


22 DRPTR 


27 


TERM TYPE |BW|EB|NF| DEFAULT SPEED 


23 DLAST 
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1 






%30 

| 


POINTER TO NEXT DIT IN TBUF WAIT LIST 


\2k DTBL 


31 


POINTER TO SAVED TBUF AFTER TBUF WAIT 


j 25 DNXTB 


32 


TOTAL READ TIME / 1ST WORD OF TIMER READING 


|26 DRTIME/DRTIMED 


33 


2ND WORD OF TIMER READING 


|27 


3U 


MAX READ TIME IN SECONDS 


| 28 DRTMAX 


35 


LF SYNC | CR SYNC | SYNC COUNT 


| 29 DSYNC 


36 


IOQP TO INFO ON SAVED BROKEN READ DATA 


|30 DBREAK 


37 


261*0 TRLX | LGON/HNGUP/RDTIMR TRLX 


131 DTRLX 


JtUo 


CFAIL TRLX ! TURN TRLX 


!32 


Ul 


NUMBER OF BYTES IN OUTSTANDING TANKS 


|33 DTANKB 


U2 


LGNTY|SYNST| CFAIL COUNT | LF COUNT 


|3fc DMONTR 


1*3 


POINTER TO BEGINNING OF SIO PROGRAM 


|35 DSIOPC 


UU 


POINTER TO SECOND TBUF USED FOR READ 


|36 DBLKTAIL 
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DIT INFORMATION 



- DFLAG 
.TERM 
.UP 



(0:1) - SET IF DEVICE IS A TERMINAL 

(1:1) - SET IF DEVICE IS ON LINE AND HAS BEEN SPEED SENSED, 
OR HAS BEEN INITIALIZED (BY ALLOCATING TERMINAL) 
AND READY TO DO 10 
ACTIVE (2:1)- SET IF IOTERMO IS CURRENTLY ACTIVE SERVICING THIS 

TERMINAL 
REQUEST (3:1)- SET IF SERVICE FOR THIS TERMINAL IS REQUESTED 
WHILE IOTERMO IS ACTIVE 

SET IF SPECIAL INTERUFT HANDLER IS USED, NOT 
APPLICABLE 

- A READ OERATION TO USE SYSBUF HAS BEEN REQUESTED 
THROUGH THE PTAPE PROCEDURE 
SET IF SIO PROGRAM TO CONTROL MODEMS IS 
CURRENTLY ACTIVE 
.PAIR (7:1) - SET (1) WHEN NO READ IS IN PROGRESS, OR (2) DURING 
READING, THE NEXT CHARACTER INPUT MAY REQUIRE SOME 
SPECIAL ACTION, SEE PAIRCODE FOR DETAILS 
.NEWLINE (8:1) - SET IF THE LAST CHARACTER OUTPUT IS A LF, USED 
TO DETERMINE IF A CR/LF IS NECESSARY DURING 
MODE CHANGES OR AT FOPEN TIME 
.PTYCHK (9:1) - SET IF PARITY CHECKING/GENERATION IS ENABLED, ODD/ 

EVEN PARITY IS DETERMINED BY ODDPTY IN DCNTRL 
.TERMCHAR (10:1) - SEE BINREAD 
.BINREAD (11:1) — 

TERMCHAR BINREAD 



.SPECIH (k:l) - 
.SPOOLING (5:1) 
.MODACTIVE (6:1) 








1 
1 




1 





1 



REGULAR READ 

BINARY READ IN PROGRESS, THE READ 
IS ONLY TERMINATED WHEN THE 
REQUESTED BYTE COUNT IS SATISFIED 
SPECIAL EOR CHARACTER IS SPECIFIED 
IN QP2 TO TERMINATE READ 
TRANSPARENT READ IN PROGRESS, NO 
EDITING IS PERFORMED ON INPUT DATA, 
READ IS TERMINATED BY EOR CHARACTER 
SPECIFIED IN DSTOP OR QP2 OR SUBSYS 
BREAK CHARACTER IN DSTOP 



.ENQACKWAIT (11:1) 



DURING WRITE, BIT 11 IS SET WHEN THE CURRENT 
CHANNEL PROGRAM SUSPENDS THE WRITE BY SENDING 
AN ENQ AND THEN WAITS FOR AN ACK FROM THE 
TERMINAL 
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. DSTATE ( 12 :U) - DEVICE STATE OF THE TERMINAL, SPECIFIES THE 

CURRENT ACTIVITY AND DETERMINES THE NEXT STATE 

1 - WRITING 

2 - READING 

U - TURN202; CURRENTLY TURNING AROUND THE 202 MODEM TO DO 
READ OR WRITE, NEXT DSTATE IS IN DCNTRL . NXTDSTATE 

6 - EORLF; END OF RECORD CARRIAGE CONTROL IN PROGRESS, NULL 

STATE NEXT 

7 - SPDSENSW -- SPEED SENSE SIO IN PROGRESS 
5110 - EORSYNC 

%11 - WAITED; READ OR WRITE OPERATION BEING SUSPENDED, WAITING 
FOR IOTERMO TO CHECK IF BREAK IS ALLOWED 

%lk - REPEATING; " ! ! ! " BEING WRITTEN AFTER CONTROL X IS 
DETECTED, EORLF NEXT TO OUTPUT CR/LF 

%16 - MODEMSIO; CHANNEL PROGRAM CURRENTLY ACTIVE IN SETTING UP 
THE ADCC MODEM CONTROL LOGIC. WHEN THE CHANNEL PROGRAM 
COMPLETES, IF DCNTRL. DOMOD IS SET, A NEW CHANNEL PROGRAM 
IS STARTED TO SET THE MODEM LOGIC TO A NEW SET OF 
CONDITIONS. THE NEXT DSTATE IS IN NXTDSTATE. 

%1J - FINREAD; FINISH UP READ OPERATION AND PERFORM THE DSTATE 
INDICATEDIN NXTDSTATE. 

1 - DLINK 

LINK WORD FOR A LINKED LIST OF DEVICES WAITING FOR SERVICE BY THE 

SYSTEM I/O PROCESS. 

=> NONE WAITING 

-1 => LAST DEVICE ON LINKED LIST 

DITP — A POINTER TO THE DIT OF THE NEXT WAITING DEVICE 

2 - DIOQP 

SYSDB RELATIVE POINTER TO THE 1ST IOQ ELEMENT IN THE SERVICE 
REQUEST LIST FOR THIS DEVICE 

3 - DLDEV 

.FLUSH (0:1) - SET WHEN A BREAK HAS BEEN DETECTED AND ACCEPTED. 
AS LONG AS IT REMAINS SET, ALL WRITE REQUESTS ARE 
RETURNED AS COMPLETED WITHOUT ANY ACTUAL I/O 
BEING PERFORMED. READS ARE RETURNED WITH AN 
UNUSUAL CONDITION STATUS, %173- 
.NOCXECHO (1:1) - IF SET, THEN "!!!" IS NOT ECHOED WHEN A CONTROL 

X TO DELETE A LINE HAS BEEN DETECTED 
.RDFLUSH (2:1) - NO TBUFS; FLUSH READ, WAIT FOR EOR 
.LDEVN (8:8) - LOGICAL DEVICE NUMBER 
DO STAT REQ (3:1) - SET WHEN A STATUS REQUEST IS NEEDED FROM A 2631B 

REMOTE SPOOLED PRINTER. 
SYNCSTATE (U:U) - SAVES SYNC CHARACTER INTERRUPT CODE FOR HALF 

DUPLEX MODES. 
.ABORWRT (5:1) - WRITE SIO HAS BEEN ABORTED 
k - DDLTP 

SYSDB RELATIVE POINTER TO THE DRIVER LINKAGE TABLE (DLT) 

5 - DILTP 

SYSDB RELATIVE POINTER TO INTERRUPT LINKAGE TABLE (ILT) 
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.DISCNCT 
.CFAILTO (2:1) 

•TURNTO (3:1) 
.26U0TO (i*:l) 



6 - DRQST 

REQUESTS FOR IOTERMO SERVICE THAT HAVE BEEN GENERATED BY TIP. 
THE REQUESTS ARE SERVICED IN A LEFT TO RIGHT ORDER, SO THE BIT 
POSITION DETERMINES THE REQUEST PRIORITY. 
.HANGUP (0:1) - DATASET HANGUP TIMEOUT HAS BEEN COMPLETED 

(1:1) - DATASET HAS BEEN DISCONNECTED (CC HAS DROPPED) 

TIMEOUT FOR CARRIER FAIL HAS BEEN COMPLETED, 

HANGUP A 103 MODEM OR TRY TO TURNAROUND A 202. 

CB OR SB FROM THE 202 MODEM DID NOT RISE 5 SECONDS 

AFTER STARTING THE "READ TO WRITE TURNAROUND", 

HANG UP THE DATASET. 

A 10 SECOND TIMEOUT TO WAIT FOR AN ACK FROM THE 

TERMINAL HAS EXPIRED, TERMINATE THE WAIT AND 

RESTART THE WRITE OPERATION 
.SPOOLSW (6:1) - ONE OF THE TWO SYSBUFS USED FOR PTAPE READ HAS 

BEEN FILLED, SWITCH THEM SO THAT IT CAN BE EMPTIED 

ONTO DISC. 

- A CONTROL Y TO TERMINATE PTAPE READHAS BEEN 
DETECTED 

A READ OPERATION HAS BEEN TIMED OUT 
.ONLINE (9:1) - ALSO SPFOUND, A CR HAS BEEN INPUT AND SPEED 
SENSED, INITIATE A LOG ON TIMEOUT 

- DATASET READY (CC) HAS BEEN DETECTED, INITIATE 
A LOGON TIMEOUT 

- A LOGON TIMEOUT HAS EXPIRED AND THE CALLER STILL 
HAS NOT LOGGED ON; HANGUP THE DEVICE 

BREAK HAS BEEN DETECTED, OR SB FROM THE DATASET HAS 
DROPPED DURING A WRITE OPERATION 
.SSBRK (13:1) - A SUBSYSTEM BREAK HAS BEEN DETECTED 
.BLOCKTO (1U:1) - BLOCK MODE READ HAS TIMED OUT 
.STATDONE (15:1) - 
DTYPE 

•TIMING (0:1) - SET IF THE TIME REQUIRED TO DOMPLETE THE CURRENT 
READ OPERATION IS TO BE RECORDED, THE STARTING 
TIME HAS BEEN RECORDED IN DRTIME, WHEN THE READ 
IS COMPLETED, THE ELAPSED TIME WILL BE SAVED IN 
DRTIME 
.TIMEREAD (1:1) - SET WHEN THERE IS A REQUEST TO MEASURE THE TIME 
REQUIRED TO COMPLETE A READ OPERATION, CAUSES 
TIMING TO GET SET WHEN THE READ IS INITIATED. 
THIS FIELD CONTAINS A CODE WHICH SPECIFIES THE 
REQUIRED ACTION WHEN A CONTROL H IS DETECTED 
SET FOR TERMINALS THAT RESPOND TO A FORMFEED, IF 
CLEAR, A LF IS SENT IN PLACE OF THE FF CHARACTER; 
THE CHARACTER TO BE OUTPUT (FF OR LF) IS PRECEDED 
BY A XOFF AND CR. 
TTYPE (5:5) " TERMINAL TYPE, A SUBSET OF THE SERIES III TERM TYPES 
WAITXON (10:1) - WAITING FOR XON 

CONSINTRPT (11:1) - SET IF CONTROL A CAN BE ACKNOWLEGED WHEN THE 

TERMINAL IS USED AS A SYSTEM CONSOLE 



.SPOOLEND (7:1) 

.READTO (8:1) - 
(9:1) - 

.DSETRDY (10:1) 

.LOGONTO (11:1) 

.BRK (12:1) - A 



.DELECHO (2:2) ■ 
.FORMFEED (U:l) 
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.PAIRCODE (12 :k) - WHEN THE NEXT INCOMING CHARACTER MAY REQUIRE 

SPECIAL ACTION, THIS FIELD CONTAINS A SPECIAL 
CODE SPECIFYING THE CONDITIONS AND ACTIONS TO 
BE TAKEN: 
Q - NO READ IN PROGRESS 

1 - CRWAIT; A BLOCK MODE READ HAS BEEN SATISFIED AND STOPPED, 

NOW WAITING FOR A CR TO COMPLETE THE READ 

2 - CRWAITLF; SAME AS CRWAIT BUT AFTRE THE CR IS DETECTED, A 

LF IS TO BE ECHOED IF REQUESTED 

3 - NOECHO; A TERMTYPE 11 READ HAS BEEN STARTED WITH ECHO OFF, 

IF THE FIRST INCOMING CHARACTER IS A DC2, THEN A BLOCK 
MODE READ IS ABOUT TO BEGIN, OTHERWISE THE CHARACTER IS TO 
BE ECHOED BACK TO THE TERMINAL AND ECHO TO BE TURNED BACK 
ON. 

k - DC2PAIR; THE LAST CHARACTER READ WAS A DC2, IF THE NEXT 
CHARACTER IS A CR AND IF OWN DC1/DC2 HANDSHAKE IS ENABLED, 
THE READ OPERATION WILL BE COMPLETE; IF THE NEXT CHARACTER 
IS A CR AND OWN DC1/DC2 HANDSHAKE DISABLED, THEN THE CR 
IS IGNORED AND READ WILL CONTINUE. 

5 - NODATAYET; A REGULAR READ HAS BEEN STARTED WITH ECHO ON. 



DMODEM 
.PREMPT (0:1) 



.MTYPE (1:3) 



- WHEN SET BY ATTACHIO, 

IS PREEMPTIVE 
MODEM TYPE: 



AT LEAST ONE PENDING REQUEST 



.CF 
.SB 



0*:1) 
(5:1) 
(6:1) 



- HARDWIRED TERMINAL 

1 - 103 MODEM 

2 - 202C MODEM 

3 - 2002 MODEM 

U-7 => SAME AS 0-3, BUT NO SPEED SENSING 
(6&7 NOT CURRENTLY SUPPORTED) 
CURRENT CARRIER DETECT STATUS FROM MODEM 
CURRENT CLEAR TO SEND STATUS FROM MODEM 
CURRENT SECONDARY RECEIVE STATUS FROM MODEM 



.PRIMED (10:1) 



•TMODE (11:2) 



DC2 HAS BEEN RECEIVED FROM THE 
FAST READ. A BLOCK MODE READ IS 



.NOSYNC (7:1) - SET FOR HP263X, HP26J+X TERMINALS; INDICATES THAT 
NO DELAYS BETWEEN CHARACTERS ARE NECESSARY FOR 
THIS TERMINAL, INSTEAD, AN ENQ IS SENT AFTER EVERY 
80 CHARACTERS AND THE WRITE OPERATION IS SUSPENDED 
UNTIL AN ACK IS RECEIVED OR A 10 SECOND TIMEOUT 
OCCURS. 
- INDICATES THAT A 

TERMINAL DOING A 

IN PROGRESS. 
TERMINAL MODE: 

- NORMAL 

1 - BREAK MODE 

2 - CONSOLE MODE 

3 - CONSOLE MODE AND RETURN TO BREAK MODE 
.LPLEVEL (13:3) - PREEMPT LEVEL OF LAST REQUEST, IF PREEMPT LEVEL 

OF THE NEW REQUEST IS HIGHER, CR/LF IS TO BE OUTPUT 
TO THE TERMINAL: 
- NORMAL REQUEST 

2 - NORMAL REQUEST WITH TERMINAL IN CONSOLE MODE 

3 - SOFT PREEMPT (PREEMPT READ OPERATION THAT 

HAS NOT INPUT ANY DATA YET) 
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k - HARD PREEMPT (PREEPMT ALL READS) 



9 - 



DSPEED 
.TAPEMODE 



(0:1) 
.RESTART (1:1) ■ 



.ECHOON (2:1) 
.ECHO (3:1) - 



CURRENT INPUT IS FROM PAPER TAPE, INCOMING 
CHARACTERS ARE TRANSPARENT 
WHEN THE TERMINAL IS IN TAPEMODE OR BLOCK MODE 
READ AND A CONTROL X HAS BEEN DETECTED, PAIRCODE 
IS SET TO CRWAIT TO WAIT FOR A CR T TERMINATE THE 
READ, AT WHICH TIME THE READ IS TO BE RESTARTED 
- ECHO WAS TURNED OFF, REENABLE IT FOR CURRENT 

OPERATION 
IF SET, ALL INCOMING CHARACTERS ARE TO BE ECHOED IF 
OPERATING IF FULL DUPLEX MODE 
SPDSENSING (U:l) - SET IF CURRENTLY IN SPEED SENSE MODE, THE 

FIRST PORTION OF A POSSIBLE CR HAS BEEN 
IDENTIFIED AND WAITING TO RECEIVE THE REST OF 
THE CHARACTER. 
SSBRKOK (5:1) - SUBSYSTEM BREAKS HAVE BEEN ENABLED VIA A FCONTROL 
CALL. 
CONTAINS AN ADCC CODE FOR THE CURRENT OUTPUT 
BAUDRATE; ADCC CODES FOR DIFFERENT BAUDRATES: 
% 7 - 2U0 CPS 

- 960 CPS 

- U80 CPS 

- 120 CPS 

- 30 CPS 

- 15 CPS 

- 10 CPS 

RESTART IDLE WAIT OR SPEEDSENSE AFTER 
CURRENT CHANNEL PROGRAM COMPLETES. 

.BRKOK (11:1) - BREAK IS ALLOWED IF SET, OTHERWISE IGNORED. SET 

AND CLEARED VIA FCONTROL CALLS. 
.INSPEED (12 :k) - CANTAINS AN ADCC CODE FOR THE CURRENT INPUT BAUDRATE 



.OUTSPEED (6:U) 



f.10 
foil 
%13 
%15 
%l6 

%U 
.RESTARTSPDS (10:1) 



10 - DCNTRL 

.HIOPWAIT 



(0:1) 



.LFLAST 
.SPDSIO 



(1:1) 
(2:1) 



- THE ACTIVE CHANNEL PROGRAM CANNOT BE HALTED 
IMMEDIATELY WHEN AN HIOP INSTRUCTION WAS 
EXECUTED; A SUBSEQUENT INTERRUPT WILL OCCUR AND 
SOFTWARE IS TO IGNORE IT. 
A POSTSPACE LF HAS BEEN TANKED INTHE WRITE TBUF'S 
SET WHEN AN IDLE WAIT CHANNEL PROGRAM IS ACTIVE, 
WHEN THE TERMINAL IS NOT ACTIVE DOING READ/WRITE, 
AN IDLE WAIT PROGRAM IS STARTED TO LISTEN TO 
THE KEYBOARD. 
•DONXTMOD (3:3) - AN ATTEMPT TO START A CHANNEL PROGRAM TO CONTROL 
THE ADCC MODEM LINES FAILED BECAUSE A PREVIOIUS 
MODEM CONTROL PROGRAM IS STILL ACTIVE. THIS 
FIELD CONTAINS A CODE SPECIFYING THE CONTROL TO 
BE DONE WHEN THE PREVIOUS CHANNEL PROGRAM 
COMPLETES AND THE NEW ONE CAN BE STARTED. 
ATTEMPT TO START A MODEM CONTROL CHANNEL PROGRAM 
FAILED BECAUSE A PREVIOUS ONE IS STILL ACTIVE; 
WHEN IT COMPLETES, START THE MODEM CONTROL CHANNEL 
PROGRAM AS SPECIFIED IN DONXTMOD 



.DOMOD (6:1) 
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.PTYON (7:1) 
.ODDPTY (8:1) 
.NXTDSTATE (9 



- SPECIFIES PARITY GENERATION ON WRITE DATA AND 
PARITY CHECKING ON READ DATA 
- IF SET, ODD PARITY IS USED FOR GENERATION AND 
CHECKING, OTHERWISE EVEN PARITY IS USED. 






ZOWl 



*S THE NEXT DSTATE TO BE USED WHEN A 202 



MODEM TURNAROUND IS COMPLETED, ALSO CONTAINS 
THE NEXT DSTATE WHEN A FINISHREAD (DSTATE=%17) 
OPERATION IS COMPLETED. 
.PRESPLAST (13:1) - INDICATES THAT THE LAST WRITE OPERATION WAS A 

PRESPACE WRITE, IF THE NEXT WRITE IS POSTSPACE 
AND NEWLINE IS NOT SET THEN A CR/LF IS OUTPUT 
TO START WRITING A NEW LINE. 
1) - INDICATES THAT ICTERMO IS CURRENTLY TRANSFERRING 

WRITE DATA FROM THE CALLER'S STACK INTO A TBUF. 
.) - IOTERMO IS CURRENTLY PUTTING AN ENQ INTO THE TBUF 
AFTER 80 BYTES OF WRITE DATA HAVE BEEN TANKED. 



.FILLING (Ik 
.ADDENQ (15:1 



11 - DRBCT 

HOLDS THE REQUESTED READ/WRITE BYTE COUNT 

12 - DBCNT 

DURING A READ OPERATION, IT SPECIFIES THE NUMBER OF BYTES THAT 
HAVE BEEN READ. DURING A WRITE OPERATION, IT SPECIFIES THE 
NUMBER OF BYTES REMAINING TO BE WRITTEN. 



13 - DSAVE 

.WAITEDSTATE (0: 



.HSTATE (U:3) 



:k) - HOLDS THE CURRENT DSTATE WHEN A BREAK IS 

DETECTED AND THE CURRENT OPERATION SUSPENDED 
SO THAT IOTERMO MAY CHECK THAT BREAK IS ALLOW- 
ED, IF DISALLOWED, THE CURRENT DSTATE WILL BE 
RESUMED. 

THE MODEM HANGUP STATE: 

- 



j. 
2 
U 
6 



.TURNTOWRT (7:1 
.DELACK (8:1) - 



7 - 



.CC (9:1) - THE 
.BLOCKRD (10:1) 



.AUTOEJECT (11 
.NOTLOGON (12:1 



NULL OR HUNGUP 
ON LINE OR NORMAL OPERATION 
LOGGINGON; LOG ON TIMEOUT IN PROGRESS 
DCLOSE ISSUED, DISCONNECT NEXT 
HANGUPTURN; HANGUP TURNAROUND TO READ IN 
PROGRESS, THE 202 MODEM NEEDS TO BE IN A READING 
STATE BEFORE HANGUP 
HANGUP SETTLING TIMEOUT IN PROGRESS 
- WHEN THE 202 MODEM IS BEING TURNAROUND (DSTATE= 
TURN202), A 1 INDICATES TURNAROUND TO WRITE, A 
INDICATES TURNAROUND TO READ. 
AN ENQ HAS JUST BEEN SENT DURING A WRITE WHEN A 
BREAK WAS DETECTED, DELAY THE NEXT WRITE FOR 
0.5 SECOND TO AVOID OVERRUNNING THE TERMINAL. 
CURRENT DATASET READY STATUS FROM MODEM 
- DURING A READ OPERATION, 2 CHANNEL PROGRAMS, 
EACH WITH ITS OWN TBUF, ARE USED TO SERVICE 
INCOMING DATA; THIS BIT IS SET IF THE 2ND 
CHANNEL PROGRAM IS CURRENTLY ACTIVE RECEIVING 
DATA. 

2631B WILL SKIP OVER PERFORATIONS 
) - IF CLEAR AND THERE IS A LOGON TIMER GOING, THEN 
YOU ARE IN A SPEEDSENSE MODE. IF SET AND 



1) 
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THERE IS A LOGON TIMER GOING, YOU THEN ARE IN 

TIMING SEQUENCE FOR A MODEM. 
.REQSTAT (13:1) - REQUESTING 2631B STATUS 
.ININ (ll+:l) - INITIALIZING TERMINAL PORT 
• CCON (15:1) - CC ALWAYS ON 

ll* - DSTOP 

IF NOT ZERO, CONTAINS THE USER SPECIFIED SUBSYSTEM BREAK AND 

END OF RECORD CHARACTERS. IF THEY ARE SPECIFIED, THEN NO EDITING 

IS DONE TO THE INCOMING DATA DURING A READ. 

.BRKCHAR (0:8) - DETECTION OF THIS CHARACTER DURING READING CAUSES 
THE SAME ACTION AS THAT OF A CONTROL Y. 

.EORCHAR (8:8) - DETECTION OF THIS CHARACTER TERMINATES THE READ 

AND IS INCLUDED WITH THE REST OF THE READ DATA TO 
BE TRANSFERED TO THE CALLERS STACK 

15 - DWAIT 

LINK WORD FOR A LINKED LIST OF DIT'S WAITING TO DO I/O WHEN THE 

TERMINAL ACTIVITY DECREASES, 

- NONE WAITING 

-1 - THIS DIT IS THE LAST ONE ON THE LIST 

OTHER - A DIT POINTER TO THE NEXT DEVICE WAITING 

16 - DXCNT(WRITE)/DBTIME(READ) 

DXCNT (VALID DURING WRITES) INDICATES THE NUMBER OF BYTES TRANSFERRED 

SO FAR INTO TBUF'S WHEN CARRIAGE CONTROL BYTES OR DATA BYTES ARE 

BEING TANKED. USED TO RESTART THE FILL TBUF OPERATION WHEN 5U0 

BYTES HAVE ALREADY BEEN TANKED AND THE FILL OPERATION HAS TO BE 

SUSPENDED. 

DBTIME (VALID DURING READ) - TIMEOUT PERIOD FOR BLOCKMODE READ. 

17 - DRCNT 

CONTAINS THE BYTE COUNT OF THE READ DATA SAVED WHEN AN EOF WAS 
DETECTED. 

18 - DCNT 

DURING A WRITE, IT INDECATES THE NUMBER OF CHARACTERS TO BE 
WRITTEN BY THE CURRENT EXECUTION OF THE CHANNEL PROGRAM. DURING 
A READ, IT INDECATES THE NUMBER OF CHARACTERS TO BE READ BY THE 
CURRENT CHANNEL PROGRAM. WHEN=-2, IT INDECATES THAT ALL TANKED 
DATA HAS BEEN WRITTEN OUT AND THAT IOTERMO IS INTHE MIDDLE OF 
FILLING A TBUF. FILLING A TBUF. 

19 - DHEAD 

A SYSDB RELATIVE POINTER TO 

(1) DURING WRITE, THE CURRENT TBUF CONTAINING DATA TO BE WRITTEN, 

(2) DURING READ, THE 1ST TBUF ON THE LINKED LIST OF INPUT DATA. 

20 - DTAIL 

A SYSDB RELATIVE POINTER TO 

(1) DURING WRITE, THE LAST TBUF ON THE LINKED LIST OF TANKED DATA, 

(2) DURING READ, THE CURRENT TBUF USED FOR RECEIVING DATA. 
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21 - DPNTR 

A WORD POINTER USED DURING WRITES TO INDICATE THE OFFSET WITHIN A 
TBUF OF THE 1ST BYTE OF DATA TO BE WRITTEN BY THE CURRENT CHANNEL 
PROGRAM. 

22 - DPNTR 

A SYSDB RELATIVE POINTER TO A LINKED LISTOF TBUF'S CONTAINING 
THE DATA SAVED WHEN AN EOF WAS DETECTED. 

23 - DLAST 

• TERMTYPE (0:7) - THE DEFAULT OR CONFIGURED TERM TYPE. WHEN THE 
TERMINAL IS SPEED SENSED, THIS IS THE TERM TYPE 
USED. 
•BINWRT (7:1) - SET IF THE LAST WRITE OPERATION WAS IN BINARY 

MODE. 
.EIGHTBITS (8:1) - SET IF THE 8-BIT PROTOCOL IS USED AND PARITY 

GENERATION/CHECKING IS DISALLOWED. USED FOR 
TERM TYPES 12 AND 15- 
.NEWFORM (9:1) - LAST CARRIAGE CONTROL WAS A FORM FEED. 
.DEFAULTSPEED (10:6) - THE ADCC CODE OF THE DEFAULT OR CONFIGURED 

TERMINAL BAUDRATE. 

2U - DTBLK 

A DIT POINTER TO THE NEXT TERMINAL WAITING FOR A TBUF. 

25 - DNXTB 

A POINTER TO A TBUF ALLOCATED TO A TERMINAL WHICH HAS BEEN WAITING; 
THIS IS TO INSURE THAT A WAITING TERMINAL GETS AT LEAST ONE TBUF WHEN 
IT COMES TO THE TOP OF THE TBUF WAITING LIST. 

26, 27 - DRTIME 

DURING A TIMED READ OPERATION, THIS IS THE READING OF THE TIMER 
AT THE INITIATION OF THE READ. AFTER THE READ IS COMPLETED, THE 
TOTAL ELAPSED TIME IN 1/100 OF A SECOND IS SAVED INDRTIME AS A 
SINGLE WORD. IF IT IS -1 THEN THE ELAPSED TIME WAS GREATER THAN 
32K. 

28 - DRTMAX 

WHEN A TIME LIMIT ON A READ OPERATIONIS REQUESTED, THIS QUANTITY 
REPRESENTS THE MAXIMUM TIME (SECONDS) ALLOWED FOR THE READ OPERATION 
TO COMPLETE; IF THIS LIMIT IS EXCEEDED, THE READ OPERATION WILL 
BE TERMINATED. 

29 - DSYNC 

.LFSYNC (0:U) - CONTAINS THE NUMBER OF SYNC CHARACTERS TO BE SENT 
AFTER A LF IS OUTPUT 

.CRSYNC (k:k) - CONTAINS THE NUMBER OF SYNC CHARACTERS TO BE SENT 
AFTER A CR IS OUTPUT 

.SYNBCCOUNT (8:8) - SPECIFIED THE NUMBER OF DATA CHARACTERS THAT 

CAN BE TANKED BEFORE AN ENQ HAS TO BE INSERTED 
IN THE TBUF. FOR WRITE OPERATIONS TO A 26UX 
TERMINAL, AFTER 80 CHARACTERS HAVE BEEN SENT 
SINCE THE LAST ENQ OR THE LAST READ OPERATION, 
AN ENQ HAS TO BE SENT AND THE WRITE SUSPENDED 
UNTIL AN ACK IS RECEIVED. 
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30 - DBREAK 

WHEN A BREAK WAS DETECTED DURING A READ OPERATION, THE DATA ALREADY 
INPUT IS SAVED AND THIS WORD CONTAINS A POINTER TO AN IOQ USED TO 
STORE THE BYTE COUNT, TBUF HEAD AND TAIL OF THE SAVED DATA. 



31,32 - DTRLS 

HOLDS TIMEOUT REQUEST INDICES 

.26U0TRLX (0:8) - HOLDS THEN INDEX OF A 10 SECOND TIMEOUT REQUEST 
FOR THE ENQ/ACK HANDSHAKE/BLOCK MODE TIMEOUT 

- HOLDS THE LOGON, HANGUP AND TIMED READ TIME-F 
OUT REQUEST INDICES 

- HOLDS THE INDEX OF A TIMEOUT REQUEST DUE TO 
LOSS OF CARRIER DETECT FROM THE DATASET. 

HOLDS THE INDEX OF A TIMEOUT REQUEST FOR A LINE 
TURNAROUND ON A 202 DATASET. 



.RREADTRLX (8:8) 
.CFAILTRLX (0:8) 
.TURNTRLX (8:8) ■ 



33 " DTANKB 

A COUNT OF THE BYTES TANKED IN THE LINKED TBUF'S; THIS COUNT IS 
USUALLY GREATER THAN DBCNT, THE COUNT OF BYTES REMAINING TO BE 
OUTPUT, BECAUSE THE DATA IN A TBUF IS SENT OUT IN BLOCKS SEPARATED 
BY AN ENQ. 

3U - DMONTR 

.LOGONTYPE (0:2) 

.SYNCSTATE (2:2) STATE OF TANKING LF/SYNC 

=> TANK XOFF/CR; 1=> DETERMINE LF'S TO TANK 
2 => TANK LF/SYNC 
.CFAILCNT (U: 6) - A COUNT OF THE TIMES WHEN LOSS OF CARRIER 

DETECT FROM THE DATASET IS DETECTED DURING A 
READ OPERATION; WHEN THE COUNT EXCEEDS 50, THE 
USER IS HUNG UP AND THE DATASET DISCONNECTED 
.LFCOUNT (10:6) - NUMBER OF LF'S FOR %2NN CARRIAGE CONTROL 

35 " DSIOPC 

STORES THE POINTER TO THE CHANNEL PROGRAM WHICH IS TO BE STARTED 
WHEN A DATASET LINE TURNAROUND IS COMPLETE; THE CHANNEL PROGRAM 
TO BE STARTED IS EITHER FOR A READ OR WRITE OPERATION. 

36 - DBLKTAIL 

POINTER TO THE SECOND TBUF SEF FOR A READ OPERATION; 2 READ 
CHANNELPROGRAMS , EACH WITH ONE TBUF, ARE USED TO INSURE AGAINST 
DATA OVERRUNS DURING FAST BLOCK MODE READS. 
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MULTIPOINT TERMINAL DIT 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

|0 I AC I RQ 1 |0 |PM|0 |IA|0 |0 | 0| STATE |0 DFLAG 

NEXT DITP |1 DLINK 

IOQP 1 2 DIOQP 

UNIT I LDEVNT |3 DLDEVT 

DLTP |U DDLTP 

ILTP 1 5 DILTP 

RESERVED 1 6 

RESERVED j 7 

RT|LG| |8 DTIME 

GS|RE|CR|FC|MR|WP|RP|DR|UP|PS|RTR|TIM|BR|SSR|FLU|LP|9 DMISCT 

LG TY|WA|RJ|DW|DR|UR|EOD| LDEVNL |10 DLDEVL 

DSTN of terminal buffer |11 DDSBUF 

Write limit Counter |12 DWLIM 

FORMATF I Reserved |13 DFRMAT 

Dit Pointer For Next Unit jlH DNEXT 

Pointer to next Dit with postponed write |15 DNWRT 

LF|DR|BM|AT|SM|WQ|DJST | STATIONINDIT |l6 DSTA 

FIRST WORD FOR ASCII WRITES (if par 1=1) |17 DFIRST 

ACTUAL BYTE COUNT FOR READS |18 DBCNT 

READTINDEXF | LOGONTINDEXF |19 DTIND 
READTIME - 1ST WORD OF DOUBLE READTIMER READING | 20 DRTMD 

2nd WORD OF DOUBLE READTIMER READING (start) | 21 

MAXIMUM READ TIME IN SECONDS |22 DRTMAX 
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MULTIPOINT TERMINAL DIT (CONT.) 



1 2 3 *t 5 6 7 8 9 10 11 12 13 lU 15 

TERMINALTYPE | | SPEED | 23 



LOGICAL/PHYSICAL WRITE COUNTER \2h 

HOLDS UNEDITED MODE CHARS, WHILE IN BREAK MODE |25 



DSTN OF DATA SEGMENT HOLDING "HELLO" MESSAGE |26 

BYTE COUNT FOR "HELLO MESSAGE" |27 

POINTER TO NEXT DIT IN WACK Q f 28 



POINTER TO NEXT DIT IN REJECT Q 

CURRENT VERSION NO. OF IOMPTRMO (MODULE 1) 



ATTENCHAR | ENDCHAR 
DSTN OF SECONDARY TERMINAL BUFFER 



1 29 
130 



131 
132 



BYTE COUNT (READS), BUFFER LENGTH (WACK or reject | 33 
LW|ED|OB|2W|WD | GROUPINDIT |3U 



DTYPE 

DWCNT 

DBUNM 

DDSHEL 

DHBCNT 

DWACK 

DREJT 

DMOD 

DUNMD 

DDSB2 

DBCNT 

DGRP 
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MULTIPOINT TERMINAL DIT (CONT.) 



DFLAG - Flags and SIODM state. 

.ACTIVE - SIODM is currently active servicing this device. 

.REQUEST - Service for this device was requested while SIODM 
was active. 

•PREMPT - Peemptive request flag. 

.IAK - Response has occured (interrupt acknowledge flag). 

.STATE - SIODM state. 

DLINK - SYSDB relative pointer to the DIT for the next device 
requesting service or this resource. 

DIOQP - SYSDB relative pointer to the DIT for the next device 
requesting service or this resource. 

DLDEVT - Logical device number and unit number. 

.LDEVNT - Logical device number of the multipoint terminal. 

.UNIT - Unit number representing terminal address (group 
and device ID) . 

DDLTP - SYSDB relative pointer to Driver Linkage Table (DLT) . 

DILTP - SYSDB relative pointer to dummy Interrupt Linkage Table 
(ILT) to satisfy SIODM requirements (no reaal ILT is 
associated with multipoint terminals). 

DTIME - Timer flags. 

.READTOF - Read timeout has occurred. 

.LOGONTOF - Log on timeout has occurred. 

DMISCT - Miscellaneous flags. 

.GSIN - Last character received from the terminal was the GS 
character . 

.READEROR - Read error has occurred. 

.CRITICAL - If set, IOMPTRMO will not attempt to release extra 
data segments previously acquired by MPMON 
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MULTIPOINT TERMINAL DIT (CONT. ) 



.FILTERCRLFOK - Proper editing of input data with respect 
to CR and LF characters has already been 
made. 

.MARKED - This DITT has already been processed during 
construction of SUPLIST. 

.WPOSTP - Current write request has been postponed. 

.READPEND - Read request is pending against this terminal. 

•DATAREADY - Input data has been received and is ready in 
the terminal read buffer. 

.UP - Device has been initialized through the log on procedure 
or has been allocated. 

.PRESPAGEF - Last write operation was with a prespace request. 
If the next write operation is with a post space 
request, output CR and LF before data. 

.READTIMERF - Read timing requested and not yet in progress. 

.TIMING - Current read request is being timed. 

. BRKOK - System break is enabled. 

.SSBRKOK - Subsystem break is enabled. 

.FLUSH - This flag i set whenever break has been detected and 
accepted. While it is set, writes are returned 
completed without any I/O being done. Reads are 
returned with an unusual condition status %173- It 
also holds off any further break service requests. It 
is reset with a function code 25 operation. 

.LASTPREMEPT - Last request was a preemptive request. 



DLDEVL 






. LOGONTYPE 


- 0: 


JOB 




1: 


SESSION 




2: 


DATA 



WACK - If set then WACK or EOT condition has been 
detected and the terminal was placed in the 
WACK queue. 
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MULTIPOINT TERMINAL DIT (CONT.) 



, REJECT - If set then a terminal error has been detected 
and the terminal was placed in the REJECT queue. 

. DOWN - If set then this terminal was declared down 
through the console operator command or the 
configuration file. 

. DOWNREQ - If set then a request is pending to declare the 
terminal down. 

. UPREQ - If set then a request is pending to declare the 
terminal up. 

.ECHO'OFF'D - For 3270 terminals, set true if no echo print to 
the terminal is wanted. 

. LDEVNL - Logical device number of the controller servicing the 
multipoint line. 

DDSBUF - Data segment number of the terminal read buffer. 

DWLIM - Write limit counter. 

DFORMAT 

.FORMATF - This field holds information about vertical format 
specification for writes obtained from PI parameter 
of the IOQ element or from the first data byte. 

DNEXT - SYSDB relative pointer to the DITT for the next terminal 
on the same line. 

DNWRITE - SYSDB relative pointer to the DITT for the next 
terminal with postponed write. 

DSTATION - Flags and station number. 

.LFLUSH - This flag is set to indicate that data for this 

terminal already scheduled to be written from the 
output buffer should not be physically sent to the 
terminal (break or subsystem break environment). 
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MULTIPOINT TERMINAL DIT (CONT. ) 



.DISCONREQ - Request to disconnect the terminal. 
•BREAKMODE - Terminal is in break mode. 

.ATTENTERM - Terminal is in attention mode. 

.SSBMODE - Terminal is in subsystem break mode. 

.WLQUEUE - A write request was forced to be queued by MPE 
I/O system. 

.DJSTATE - State of terminal straps D and J. 

- Initial state. 

1 - Straps D and J are open or will be open 

before the next write. 

2 - Undefined D and J setting. 

. STATIONINDIT - Station number assigned to this terminal by 
CS. 

DFIRST - Storage for first word for ASCII writes if vertical 
format is specified by first data byte. 

DBCNT - Actual byte count for reads. 

DTIND - Timer indexes. 

.READTINDEXF - Read timer index. 

. LOGONTINDEXF - Log on timer index. 

DRTIME (DRTIMED) - During a timed read, this is the reading of 

the timer at the initiation of the read. 
After a timed read is completed, the time in 
1/100 of a second is saved in DRTIME as a 
single word. If it is -1 then the time was 
greater than 32K. 

DRTMAX - When a read operation timeout is requested, this 
quantity represents the maximum time in seconds 
allowed for the read to be completed. 
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MULTIPOINT TERMINAL DIT (CONT.) 



DTYPE - Terminal type and speed, 

. TERMINALTYPE - Configured terminal type. Multipoint terminal 
is type lU. 

•SPEED - Reserved field for configured terminal speed (not 
used for multipoint terminals}. 

DWCNT - Logical/physical write counter. 

DBUNMODE - Holds unedited mode characters while in break mode. 

DDSHEL - DST number of data segment holding "HELLO" message (or 
backspaced data) . 

DHBCNT - Byte count for "HELLO" message (or backspaced data) . 



DWACK - Pointer to next DIT in WACK queue. 
DREJECT - Pointer to next DIT in REJECT queue. 

DM0D1VER - Current version number of the multipoint terminal 
driver (IOMPTRMO). 

DUNMODE - Unedited mode characters. 

.ATTENCHAR - Attention character. 

.ENDCHAR - End-of- character. (Effective as a control 

character is set to ?ll37» otherwise not used). 

DDSBUF2 - Data segment number of secondary read buffer. 

DBCNT2 - Byte count for read if secondary read buffer is used 

DGROUP 

.L'WRITE'D - Set true if last I/O request was a write. 

.EOS'D - Set true if a write to a 3270 terminal reaches end 
of screen. 
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MULTIPOINT TERMINAL DIT (CONT.) 

.ODD 'BYTE' 3270 - Set true if there is an odd number of bytes in 
a write. 

.WRITEPEND - Reserved. 

.ZERO' WRITE - Set true if no byte is transmitted in a write 

because of an error other than a conversation write. 

.WRITEDONE - Set true after a write issuded is completed. 

GROUPINDIT - Logical group number assigned to this terminal 
by CS. 
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MULTIPOINT SUPERVISOR DIT 



1 2 3 U 5 6 7 8 9 10 II 12 13 lU 15 

JO JO iACiRQJO |0 jPRjO i IAJ0 |0 JO i STATE |0 BFLAG 

NEXT DITP il DLINK 

IOQP I 2 DIOQP 

UNIT | LDEVNS |3 DLDEVS 

DLTP |U DDLTP 

ILTP 15 DILTP 

RESERVED 1 6 

RESERVED ! 7 

WA|RJ| |8 DTIME 

MP|DU|DE|TO|TOR|TR|SN|SR|BH|MA|MU |GP |GD| GW |GR|CR |9 DMISCS 

RESERVED | LDEVNL |10 DLDEVL 

DIT POINTER FOR MP SUPERVISOR 111 DDITSP 

OFFSET TO TRACE BUFFER IN MPMON STACK |12 DTBOFF 

WRITE LIMIT CONSTANT I 13 DWLCON 

DIT POINTER FOR FIRST UNIT \lk DNEXT 

POINTER TO FIRST DITT WITH POSTPONED WRITE |15 DNWRIT 

CURRENT VERSION NO. OF IOMPSO (MODULE 2) |l6 DMOD2V 

ADDRESS OF LINE READ BUFFER IN MPMON STACK |17 DINBA 

ADDRESS OF LINE WRITE BUFFER IN MPMON STACK |18 DOUTBA 

OUTPUT SPEED I 19 DOSPD 
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MULTIPOINT SUPERVISOR DIT (CONT.) 



1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 
INDEX OF HEAD ENTRY IN LINE WRITE BUFFER 



INDEX OF TAIL ENTRY IN LINE WRITE BUFFER 

INDEX OF LAST AVAILABLE WORD IN LINE WRITE BUFFER 



TERMINAL TYPE |SP|DO!lD| SPEED 
CURRENT VERSION NO. OF MPMONCMD (Module 3) 



DSTN OF MPMON STACK 

1st WORD 



LINE SPEED 
DLSPEED 



LINE SPEED - 2nd WORD 
POINTER TO FIRST DIT IN WACK Q 



POINTER TO FIRST DIT IN REJECT Q 



WACKTINDEX 



CFCHARO 
CFCHAR2 



CFCHAR k 
CFCHAR6 
RO|UDR|FB|CD|FS|DI| 



REJECTTINDEX 



CFCHAR1 
CFCHAR3 



CFCHAR5 
CFCHAR7 



|DUS|MM| UD|MO 



20 DHEADI 


21 DTAILI 


22 DENDI 


23 DTYPE 


2k DMOD3V 


25 DMDSTN 


26 


27 


28 DWACK 


29 DREJ 


30 DWRTI 


31 DCF01 


32 DCF23 


33 DCFll5 


3U DCF67 


35 
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MULTIPOINT SUPERVISOR DIT (CONT. ) 



DFLAG - 

DLINK - Same as for DITT 

DIOQP - 

DLDEVS - Logical device number and unit number. 

.LDEVNS - Logical device number of the Multipoint Supervisor. 

.UNIT - Unit number (always 0). 

DDLTP - Same as for DITT 
DILTP 

DTIME - 

.WACKTO If set, then WACK timeout has expired 
.REJECTIO If set, then REJECT timeout expired. 

DMISCS - Miscellaneous flags. 

.MPOK - If set, then IOMPSO is allowed to process I/O requests 
against the Multipoint Supervisor. 

.DUPLEX - Reserved. 

.DEBUGON - If set, then DEBUG will be called from MPMON. This 
flag is set through the MPLINE command. 

.TRACEON - Trace facility is enabled. 

.TRACEOFFREQ - Trace facility is to be disabled. 

.TRACEONREQ - Trace facility is to be enabled. 

.SHUTNOW - Request to shut the line immediately. 

.SHUTREQ - Request to shut line after all terminals are 
released 
New sessions are not allowed to be initiated. 

.BUSYHEAD - The line write buffer contains data to be written 
to a terminal on the line. 
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MULTIPOINT SUPERVISOR DIT (CONT. ) 

.MPONACT - MPMON process is active. 

.MPMONUP - MPMON process has been created and activated. 

•GENWPOSTP - A write request for one or more terminals on the 
line has been postponed. 

.GENDISCON - Request to disconnect the line. 

.GENWACK - If set then there is a terminal in the WACK queue. 

.GENREJECT - If set then there is a terminal in the REJECT 
queue . 

•COMPLREQ - Request to complete dummy read pending against the 
Multipoint Supervisor. 

DLDEVL 

.LDEVNL - Logical device number of the controller servicing the 
multipoint line. 

DDITSP - SYSDB relative pointer to the DIT for the Multipoint 
Supervisor (DITS). 

DTBUFOFFS - Offset to the trace buffer in MPMON stack. 

DWLCON - Write limit constant. 

DNEXT - SYSDB relative pointer to the DITT for the first terminal 
on the line (the terminal with the lowest logical device 
number) . 

DNWRITE - SYSDB relative pointer to the DITT for the first 
terminal with postpond write. 

DM0D2VER - Current version number of the Multipoint Supervisor 
driver (IOMPSO). 

DINBUFA - Address of the line read buffer in MPMON stack. 

DOUTBUFA - Address of the line write buffer in MPMON stack. 

DOSPEED - Output speed. 

DHEADI - Index of head entry in the line write buffer. 

DTAILI - Index of tail entry in the line write buffer. 
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MULTIPOINT SUPERVISOR DIT (CONT.) 



DENDI - Index of last available word in the line write buffer, 
DTYPE 

. TERMINALTYPE - Configured terminal type. Multipoint 
Supervisor is type lU (same type as 
multipoint terminals). 

.SUPER - This device is a Multipoint Supervisor. 

.DITSOK - DIT's for the multipoint terminals and the 

Multipoint Supervisor on this line have been 
rearranged and their format corresponds to 
standard DIT format for SIO devices. 

.SPEED - Reserved field for configured terminal speed 
(not used for Multipoint Supervisor). 

.INITDONE - If set then all multipoint terminals belonging to 
the same multipoint supervisor have been linked. 

DM0D3VER - Current version number of the MPLINE command 
processor (MPMONCMD) . 

DMONDSTN - Data segment number of MPMON stack. 

DLSPEED (DLSPEEDD) - If not equal to 0, then the line is opened 

with speed specified in this double word. 

DWACK - Pointer to the first terminal DIT in the WACK queue. 

DREJECT - Pointer to the first terminal DIT in the REJECT queue. 

DWRT1 

.WACKTINDEX - WACK timer index. 
.REJECTTINDEX - REJECT timer index. 

DCF01 through DCF67 - String of characters representing: 

a) the name of the configuration file, or 

b) the logical device number of the terminal, or 

c) terminal group and device ID. 

DCONFL 

.REOPEN - If set then a request for line reopening has been 
made. 

.UPDOWNREQ - If set then a request to set the terminal UP or 
DOWN has been made. 
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MULTIPOINT SUPERVISOR DIT (CONT. ) 

.FALLBACK - Reserved. 

.CHDUPL - Reserved. 

.FORCE 'SHUT - If set then a request has been made to shut the 

line immediately. 
.DUMP'INP - Reserved. 

•DUPLEX 'SPEC - Reserved. 

.MON'MODE - Reserved. 



•UP 'DOWN - If true then the terminal is to be set UP else the 
terminal is to be set DOWN. This flag is used in 
conjunction with .UPDOWNREQ flag. 

•MSGOFF - If set then certain MTS messages are not displayed on 
the operator console. 
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2 CHAPTER 22 DISC FREE SPACE MAP 

3 

k 

5 22.1) Disc Resident Data Structures 

6 

7 There are two disc resident free space data structures, the 

8 bit map and the descriptor table, for each disc volume that 

9 has a free space map, i.e. system discs and private volumes. 

10 The addresses of these data structures are kept in the disc 

11 label. The symbols that define the descriptor table and bit 

12 map are in the include file INCLDFS2. 

13 

lit 

15 22.1.1) Bit map 

16 

17 The bit map is divided up into pages, which is the physical 

18 block of the map that is read or written. At the moment, a 

19 page is defined to be one sector (128 words) long, this may be 

20 changed by changing a compile time constant. The last word of 

21 the page is a checksum for that page, all other words are 

22 data. There is a one to one correspondence between bits in 

23 the map and sectors of the disc. A one bit represents a free 
2k sector and a zero bit represents an allocated sector. The bit 

25 map is a contiguous set of pages, enough to represent the en- 

26 tire disc, excluding spare tracks and spare sectors. 

27 

28 

29 22.1.2) Descriptor table (DT) 

30 

31 The descriptor table is an array of three word entries, one 

32 entry for each page of the bit map. Each entry looks like 

33 this : 
31* 

35 
36 
37 
38 
39 
U0 
i.i 

U2 
U3 
kk 

),c 
-'J 

k6 

U7 

U8 

U9 
50 



word 


= 


largest space 


= 


word 1 


= 


starting space 


_ 


word 2 


= 


ending space 


= 
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51 Thus the descriptor table looks like this: 
52 

53 -- 

5*t = = entry for page 

55 

56 = = entry for page 1 

57 

58 = = entry for page 2 

59 

60 = = entry for page 3 

61 

62 
63 
6k 

65 

66 = = entry for last page 
61 

68 

69 Each entry describes the free space on the corresponding 

70 page of the bit map. The largest space word is the size of 

71 the largest contiguous block of free space on the page, which 

72 is not at the very beginning or very end of the page. That 

73 is, the first bit physically representing the space is not the 
7k first bit of data on the page or the last bit representing the 

75 space is not the last bit of data on the page. Starting space 

76 is the number of sectors of contiguous space represented by 

77 the set of bits whose first bit is the first bit of data on 

78 the page. Ending space is the number of sectors of contiguous 

79 space represented by the set of bits whose last bit is the 

80 last bit of data on the page. The starting space and ending 

81 space fields allow looking across page boundries, thus pre- 

82 venting fragmentation on page boundries. Thus, if all sectors 

83 represented on a page are free, then starting and ending space 
8k will be the same and have the total number of free sectors 

85 represented on the page. Largest space will be zero, as there 

86 is no block of space that is not at the beginning or end of 

87 the page. A value of -1 for all the fields in an entry in- 

88 dicates the corresponding page is bad, either from a checksum 

89 or I/O error. 
90 

91 

92 

93 22.2) Virtual Memory Resident Data Structures 

9k 

95 For each system disc or physically mounted private volume 

96 there is a data segment which has information about the disc 

97 free space map, the current copy of the descriptor table, some 

98 work space for the procedures while in spilt stack mode and 

99 buffers for pages of the bitmap. The DST number of the data 

100 segment for a given disc is found in the LDTX entry for that 

101 disc. 
102 
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10U 22.2.1) Disc Free Space Data Segment 
105 

106 For each system disc or physically mounted private volume 

107 in the up and running system there is a DST which contains 

108 info about the disc free space map for that disc, some work 

109 area, a copy of the descriptor table and buffers for the pages 

110 of the bit map. All symbols that define these data segments 

111 are in the include file INCLDFS1, and they are prefixed with 

112 "ds"'. The structure of the data segment is as follows: 
113 

111* 
115 
116 
117 
118 

119 
120 
121 
122 
123 
12** 
125 
126 
127 
128 
129 
130 
131 
132 
133 
13** 
135 
136 
137 
138 

139 
1U0 

11*1 
ll*2 

1 1,-5 

J-tJ 

U+l» 
ll*5 

11*6 

1 l.T 
it I 

ll*8 
ll*9 
150 

151 
152 
153 
155 
156 19 (%23) = ds' last 'page 'allocated 'from 
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(%0) 


= 


ds ' ldev 


= 


1 (%1) 


= 


ds'dst 


= 


2 (%2) 


_ 




= 


3 (%3) 




= 


1* CJUO 


= 


ds ' las t ' page 'of map 


= 


5 (%5) 


= 


ds ' last 'buff er ' index 


= 


6 (*6) 


- 




= 


7 (%7) 




= 


8 (#10) 


= 


ds'lock 


= 


9 (%ll) 


= 


ds' lock 'count 


= 


10 (#12) 


= 


ds' queue 'head 


= 


11 (%13) 


= 


ds 'queue 'tail 


= 


12 (JtLU) 


= 


ds 'descriptor'table 


= 


13 (#15) 


= 


ds 'buffer 'page 'number 


= 


11* (7.16) 


= 


ds' buffer 'dirty 


= 


15 (#17) 


= 


ds ' buffer ' area 


= 


16 (#18) 


= 


ds ' first ' threshold 'page 


= 


17 (%21) 

18 (f.22) 


= — 


ds ' s ize ' of ' last ' allocat ion 


= 











157 
158 

159 
160 
161 
162 
163 
16U 

165 
166 
167 
168 
169 
170 
171 
172 
173 
17 1 * 
175 
176 
177 
178 

179 
180 
181 
182 
183 
18U 

185 
186 

187 
188 

189 The rest of the data segment contains tables whose size and 

190 location is dependent on the size of the disc and or the num- 

191 ber of buffers in the data segment. They are shown below just 

192 to demons tarate there relation to one another, for there ac- 

193 tual location, the pointers should be examined. The symbol 
I9U "ds' array 'area" defines the start of the area. 

195 

196 The first table is the descriptor table, it is in the same 

197 format as the disc copy, but a dummy entry of all zeros is 

198 added before and after the table, these are needed by proced- 

199 ures "Find'Page" and "Build 'Descriptor' Entry". The pointer to 

200 this table is "ds' descriptor 'table", it points to the entry 

201 for page zero, not the dummy entry. 
202 

203 

205 =================================== 

206 

207 = = dummy 

208 

209 = = entry 
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20 (%2l+) 


= 


ds 


'next 'buffer ' index 


= 


21 (%25) 


= 




ds ' page ' number 


= 


22 (%26) 


= 




ds' word 'number 


= 


23 (%27) 


= 




ds 'bit 'number 


= 


2U (%30) 


= 




ds 'page 'pointer 


= 


25 (*3D 


= 


ds' 


start ing ' word ' number 


= 


26 (%32) 


= 


ds' 


starting 'bit 'number 


= 


27 (%33) 

28 (%3*0 


= 


— ds 


i 'number 'of 'sectors 


= 


29 (%35> 


= 




ds 'bit 'count 


= 


30 (f.36) 


= 




ds ' entry ' type 


= 


31 (%37) 


= 




ds 'buffer' index 


= 


32 (f.1+0) 








= 


33 (JtUl) 




= 


3U (%U2) 


= 




ds' error 'status 


= 



210 

212 = largest space = 

213 = = entry for 

21 1* = starting space = 

215 = P a § e ° 

216 = ending space = 

218 = largest space = 

219 = = en "try f° r 

220 = starting space = 

221 =- = page 1 

222 = ending space = 

22lt 
225 
226 

227 =================================== 

228 = largest space = 

229 = = entry for 

230 = starting space = 

231 s — = last P a g e 

232 = ending space = 

233 =================================== 

23U = = 

235 = = dummy 

236 

237 = = entry 

238 

2U0 

2Ul The next table is ds' buffer' page' number table, it has a one 

2U2 word entry for each buffer in the data segment. Each entry 

2U3 contains the page number of the page currently in the corre- 

2kk sponding buffer or -1 if the buffer is empty. This is pointed 

2^5 to by "ds' buffer' page 'number". 

2U6 

0)1 "7 === ==== ===== ==== === ===== = === === === = 

2U8 = buffer entry = 

2U9 =================================== 

250 = buffer 1 entry = 

251 s= = s = ss = = = = = ===s=== = === = = = = = = — . 

252 
253 
255 

257 = last buffer entry 

259 

260 
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261 The next table is the ds 'buffer 'dirty table, which has a 

262 one word entry for each buffer. A TRUE indicates the page in 

263 the correspnding buffer is dirty, i.e. the disc copy is not 
26U uptodate. A FALSE indicates that the buffer is clean. 

265 If DFS was compiled with dirty buffer management turned off, 

266 this table is not present and the ds' buffer' dirty pointer is 

267 zero. 
268 

269 =================================== 

270 = buffer entry = 

272 = buffer 1 entry = 

273 =================================== 

27U 
275 
276 

277 =================================== 

278 = last buffer entry = 

279 =================================== 

280 
281 

282 The remainder of the data segment contains the buffers, 

283 each buffer is the size of one page of the bit map, which is 
28U currently one sector (128 words). The beginning of the buffer 

285 area is pointed to by "ds' buffer 'area" and the number of buf- 

286 fers is the value in "ds' last 'buffer 'index" plus one. 

287 

288 =================================== 

289 

290 

291 

292 = buffer 

293 

29U = 

295 

296 =================================== 

297 

298 

299 

300 = buffer 1 

301 

302 

303 

30U =================================== 

305 
307 
308 
309 ======================== 

310 
311 
312 
313 = last buffer 
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3lU 
315 
316 
317 
318 

319 
320 
321 
322 

323 
32»t 

325 
326 

327 
328 

329 
330 
331 
332 
333 
33 1 * 
335 
336 
337 



Each of the fields of the data segment is described in the 
include file INCLDFS1, where they are defined. It should be 
noted that the following fields are just workspace, used to 
pass information between procedures while in spilt stack mode 
and have no meaning between calls to the disc free space man- 
agement subsystem: 



ds 'page 'number 

ds' bit' number 

ds' starting 'word 'number 

ds ' number ' of ' sectors 

ds 'bit' count 

ds 'disc 'address 



ds 'word 'number 

ds'page'ptr 

ds ' starting 'bit 'number 

ds ' entry ' type 

ds 'buffer' index 



The field ds 'error' status normally has no meaning between 
calls unless the error'type field has a value greater than 
" fatal *dfs' error", in which case it means that disc space may 
nolonger be allocated on this disc. 
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CHAPTER 23 CIPER TABLES 



CIPER Data Segment (CDS) Overview 

The CIPER data segment (CDS) is the primary data structure accessed 
by SOFTIO. The general format of the segment is illustrated below. 
The following data structures are expansions of the general format 
and are self explanatory within each structure detailed. 



Segment Header Area (SHA) 



Control Table Map (CTM) 

Allows Several CIPER devices to 
share a single data segment. 



Control Table (CT) 
(One per CIPER device) 
Contains global information for 
a particular device. 



Control Block (CB) 
(One per CIPER level per device) 



Control Block Information Area (CBI) 

Contains global info for a particular level. 
Similar to DIT for a physical device. 



Control Block Information Area Extension 
(CBIX) 

Contains buffers for input and output, 
status information, etc. 
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Segment Header Area (SHA) 

The SHA is the first data structure encountered within the data 
segment. There is only one Segment Header Area per segment. 



Word 


1 
2 
3 
1+ 
5 



1 2 3 ^ 5 6 7 8 9 10 11 12 13 1U 15 
i i i i i i i i i i i i i i i 



SHA ' FREE ' SPACE ' TBL * PTR 



SHA'CDS'DST'NUM 



SHA'MAX'SEG'SIZE 



SHA' SEG' SIZE 



SHA'CTM'PTR 



SHA'LIOQ'LIST'PTR 



Discussion: 

SHA ' FREE 'SPAC' TBL' PTR - Data segment base relative address of 
the upper stop boundary of the dynamically managed memory area. 

SHA'CDS'DST'NUM - The number of this data segment. 

SHA'MAX'SEG'SIZE - The maximum size this data segment is configured 
for in virtual memory (ie, maximum possible size). 

SHA'SEG'SIZE - The current size of this data segment (either 
main memory or disc). 

SHA'CTM'PTR - Data segment base relative address of the Control 
Table Map. 

SHA'LIOQ'LIST'PTR - Data segment base relative address of the 
Logical 10 Queue list (not used at this time). 
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Memory Allocation Manager Typical Layout 

The SOFTIO module contains a Memory Manager which manages all 

data structures within the CIPER/3000 data segment (CDS). The 

structures used are ambles (Pre & Post). The Preamble is two 

words in length, while the postamble is 1 word in length. The 

MAM preamble and postamble surround each portion of the CDS allocated. 



Word 
-2 

-1 




N-3 



N 



SUPER TYPE LABEL 



SUB TYPE LABEL 



Some Defined CIPER/3000 
Data Structure 
For Example: 

CBI 
CTMI 
CT 
ETC. 



N 



l»l 



Data Segment relative pointer to CIPER/3000 structure. 

NOTE: If N is less than or equal to zero then the area is currently 
deallocated. 

If N is greater than zero then the area is currently allocated. 
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Control Table Map (CTM) 

This table is a series of entries, one for each logical device. 
The LDTX contains an index to the logical device Control Table 
Hap. There is only one logical device per data segment. Therefore, 
the CTM is comprized of only one entry. 



Word 

1 
2 



N 



1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 
i i i i i i i i i i i i i i i 



CTMO'ENT'CNT 



CTMO 'CTM 'SIZE 



CTMO'ENT'INUSE'CNT 



CTM'CT'PTR 



CTM'LDEV 



(Last entry) 



CTM Header 
[entry 0] 
(3 words) 



CTM Typical 
(2 Words) 



Discussion: 

CTMO'ENT'CNT - The number of entries in the CTM (not counting the 
header entry) . 

CTMO'CTM'SIZE - The size of each entry in the CTM (disregarding 
the size of entry C, the size of each entry is currently 2). 

CTMO'ENT'INUSE'CNT - The number of entries in the CTM (not counting 
the head entry) currently in use. 

CTM'CT'PTR - Data segment base relative address of the Control 
Table (CT). 

CTM'LDEV - The logical device number for which this entry is 
associated. 
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Control Table (CT) 

The Control Table Map points to the Control Table where specific 
device, caller, and level control information is stored. 



Word 

1 
2 
3 
h 

5 
6 

7 
8 

9 

10 

11 



N 



CT'SIR 



CT' SIR 'SAVE 



CT'CDS'DST'NUM 



CT'CTMI 



CT 'MSW' CALLERS 'DB 
( CT'D' CALLERS 'DB) 
CT 'LSW' CALLERS 'DB 



CT' CALLERS 'STK 



CT * CALLERS' STK'DB 



CT'LVL'CNT 



CT'LVL' ACTIVE 



CT 'LVL' ACTIVE 'PTR 



CT'VDT'FTR 



CT'LVLl'CB'PTR 



CT'LVL2'CB'PTR 



CT'LVL3'CB'PTR 



CT'LVLU'CB'PTR 



CT'LVL5'CB'PTR 



CT'LVL6'CB'PTR 



CT'LVL7'CB'PTR 
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Discussion: 

CT'SIR - Not currently used. 

CT'SIR 'SAVE - Not currently used. 

CT'CDS'DST'NUM - The number of this data segment. 

CT'CTMI - The control table map index used to reach this control 
table . 

CT'D'CALLERS'DB - The result of the call to CHANGEDB which moved 
DB to the CIPER data segment (CDS). It is used to return DB to 
the same spot the caller had it at. 

CT' CALLERS 'STK - The dst number of the calling processes' stack. 

CT ' CALLERS 'STK'DB - The offset from the data segment base in 
the calling processes' DB. 

CT'LVL'CNT - The number of levels currently loaded into this 
control table. 

CT'LVL' ACTIVE - The level which is currently within this control 
table . 

CT'LVLl'CB'PTR - Not currently used. 

CT'LVL2'CB'PTR - Not currently used. 

CT'LVL3'CB'PTR - Not currently used. 

CT'LVLL'CB'PTR - The pointer to the control block of level four 
(network protocol) . 

CT'LVL5'CB'PTR - Not currently used. 

CT'LVL6'CB'PTR - Not currently used. 

CT'LVL7'CB'PTR - The pointer to the control block of level seven 
(the logical driver). 
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CIPER Level 'N' Control Block 

For every level that exists in the CIPER Protocal model, there is 
a control block which contains specific control information for the 
level at which the operation is being accomplished. This implementation 
of CIPER contains level 7, 6, *t, 2, and 1. Therefore, it would seem to 
follow that there are seven control blocks. However, that is a false 
assumption. Level 7 is really the user interface in which MPE is the file 
system, SPOOLER, ATTACHIO and the Logical Driver. Thus, level 7 resides 
only partially in SOFTIO. Level 6 is the CIPER translator (procedure 
CPR'XLATOR). In this implementation, it is not a user-callable intrinsic 
and hence does not need a CB of its own. However, should it ever become 
a user-callable intrinsic, it will then require a level 'N' CB. Levels 
7 and k do require control blocks since they use the data segment 
extensively. Levels 5 and 3 do not exist and do not currently need 
space. Levels 2 and 1 refer specifically to the physical driver. In 
the case of the HBIB driver, the DIT and IOQ hold the information that 
would ordinarily be in the Level 'N' CB. Thus, the HPIB driver does 
not need this structure. For the Multi-Point Terminal System (MTS), 
the process and physical driver do not require space in the data 
segment for control information. However, MTS does access the CIPER 
data segment for the data being read or written from/to the device. 

In summary: there are two level 'N' CBs for this implementation. 
There is one for Level 7 and one for Level U. The format for the 
control block is as follows: 



Word 

1 
2 



CB'PLABEL 



CB'QH'PTR 



CB'CBI'PTR 
(CB'INFO'PTR) 



CB'SIZE 



Discussion: 

CB'PLABEL - Control Block Program label. The PLABEL of the module 
which will be called for this level. Allows multiple modules for 
any level. Not currently used. 

CB'QH'PTR - Control Block Queue Head pointer. 

Data segment relative pointer to the Communication Queue Head. 

CB'INFO'PTR - Data segment base relative address to the control 
block information area. This information area is level dependent. 
The information within the 'INFO' block pointed to by CB'INFO'PTR 
contains variable length information which only the level module 
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called 'knows' about. 

CB'SIZE - currently the CB size is set to 3 words. 

NOTE: Since there are only two levels (level k and level 7)» there 
are only two level 'N' control blocks and two 'INFO' areas at 
this time. 



Communication Queue Head 

Communication Queue Heads are used for passing internal messages 
within CIPER. CIPER runs on the caller's stack. The Queue Head 
mechanism is useful for passing messages between procedures at 
the same level and to the level above and below the current level. 
This helps to synchronize all of the events occuring within CIPER. 
The level 'N' CB contains a data segment relative pointer to the 
queue head. The queue head mechanism is logically similar to the 
message harbor table mechanism in the MPE internal message system. 

When a message is to be passed by some procedure at some level, it 
merely calls one of the T'LINK'XXX procedures to do so. The memory 
manager acquires chunks of free memory in the data segment to hold 
the data. The pointers in the following table are data segment 
relative pointers to that chunk (or those chunks) of memory that are 
reserved for the message data. 



Head' entry 



Tail 'entry 



Entry 'size 



Free' list 'ptr 



Free ' count 



In 'use' count 



Max 'used' count 



Back' pointer 



Discussion: 

Head 'entry: this is a pointer to the first entry 
in the queue. Items are typically removed from 
the head. 
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Tail'entry: this is a pointer to the last entry 
in the queue. 

Entry 'size: specifies the queue entry size of all 
entries in this particular queue. Size is in words. 

Free' list' ptr: pointer to a queue of available 
entries. Elements are added and removed from 
the head. 

Free 'count: the number of queue elements available 
in the freelist. 

In 'use 'count: the number of queue elements currently 
linked in the request queue. 

Max 'used 'count: a high-water mark which tallies the 
maximum value that In 'use 'count ever assumes. 

Back'pointer: an optional backward reference pointer 
to the request queue. Could be used for a two-way 
linked list. 

In general, a given level (n) has four request queues 

associated with it. There is a command queue from 

the level above (n+1), and a response queue back to that level. 

There is also a command queue to the next lower 

level (n-l) , and a response queue from that level. 
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COMQUELEMENT (Communications Queue Element) 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
i i i i i i i i i i i i i i i 



PCB'num 



AP 



CP 



reserved 



Father 'index 



Brother ' index 



Command * array * ptr 



Data 'table 'ptr 



Discussion: 

PCB'num: the Process Control Block number of the process 
issuing the request. Maintained at all levels to facilitate 
ABORTPROCIO requests. 

A: abort bit. Set in responce to an ABORTIO(LDEV) 
command. Allows Ciper' 10 'Process to clean up the request 
as soon as possible. 

AP: process abort bit. Set in responce to an ABORTPROCIO 
command. Allows Ciper'IO'Process to clean up the request 
when it is convenient for it to do so. 

CP: Ciper'IO'Process flag, which is set if CIP issued this 
particular request, either on its own behalf or for a user process. 

Father ' index : a request queue pointer to level (n+l)'s 
queue element that caused this request to be generated. 

Brother * index : a request queue pointer to a level n 

queue element that is related to this element, by virtue 

of having the same level (n+1) queue element generating the request. 

Command 'array 'ptr: a pointer to a command array specified 

by the calling level. Contents of the command array 

depend on the interface established between levels. The 

first word will always be the request flags passed from 

the user (or CIP) which must be maintained to the lowest level. 

Data 'table 'ptr: a pointer to the virtual data table 
associated with this request. 
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Control Block Information Area 



For every level 'N' Control Block, there is a Control Block 
Information Area (CBI), In this implementation there are 2 CBI's 
since there is a level 7 and a level U Control Block. The CBI is a 
variable length extension to the CB. It can be different lengths for 
different levels. The level 7 and level k CBI7s are outlined below. 

LEVEL 7 CONTROL BLOCK INFORMATION (CBI) 

Word 




1 
2 
3 
U 

5 
6 

7 
8 

9 

10 

11 

12 
13 

Ik 
15 

16 

17 

18 

19 



CDS 'AREA' BASE 



INITIALIZED 



JOB' ACTIVE 



FREE' BUFF 'LIST 



O'R'BASE 



I'R'BASE 



DEV'STATUS'BASE 



COMPOSITE ' STATUS ' BASE 



ENV' STATUS 'BASE 



JOB 'REPORT 'BASE 



EXPANDED ' FEATURES 



INPUT * SEQUENCE ' COUNT 



OUTPUT ' SEQUENCE ' COUNT 



RECEIVE ' READY ' COUNT 



CPR'XLATOR 
FLAGS 



SEQUENCE '1' BUFFER 



O'R'DATA'TYPE 



I 'R' DATA' TYPE 



FILE 'OPEN 'COUNT 



23-11 



LEVEL 7 CONTROL BLOCK INFORMATION (CBI) CONT. 



20 
21 
22 
23 
2k 

25 
26 

27 
28 

29 
30 
31 
32 
33 
3k 

35 
36 

37 
38 

39 
1*0 

Ui 

U2 

k3 



DEVICE' ALLOCATED 



LOGICAL 'DEVICE 



CIPER'DST 



OUT ' RECS ' OVERWRITTEN 



IN ' RECS ' OVERWRITTEN 



DEVICE'BUFFER'SIZE 



DEVICE 'ENV'STATUS 'SIZE 



PRODUCT 'NUMBER 



STORAGE 'REQUIREMENTS 



TEMP 'AREA 



CT'PTR 



PACKET 'HEADER 'SIZE 



PACKET ' TRAILER ' SIZE 



PACKET 'SIZE 



DEV'CLR' COUNT 



DEV ' CLR * IN ' PROGRESS 



SR' ENABLE 



ESB' FREQUENCY 



LOGGING'DST 



LOGGING' BUFFER 



EVENT' MAP 



STATUS 'ENABLED 



STATUS' RECEIVED 



STATUS 'REPORTED 
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kk 



DEFAULT • ACCESS ' MODE 



COHP ' STAT 'AVAILABLE 
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Discussion: 

CDS' AREA' BASE - contains the CDS relative address of the 
Control Block Information extension (CBIX). The CBIX is 
the area that contains all record buffer, status tanks, 
and other arrays used by the logical driver. 

INITIALIZED - a logical flag set to true when the entire 
CBIX and all other information areas have been completely 
initialized. 

JOB 'ACTIVE - a logical flag set to true when a command has 
been sent to start a job, and that command has been passed 
to the device. 

FREE' BUFF 'LIST - a word pointer which contains the CBIX relative 
address of the first entry in a linked list of record buffer 
areas that are currently not in use. 

O'R'BASE - a word pointer which contains the CBIX relative 
address of the base of the output record buffer area. This 
buffer is normally contained within the region pointed to 
by cds' area 'base, but it does not have to be. 

I 'R' BASE - a word pointer which contains the CBIX relative 
address of the base of the input record buffer area. Like 
the output record buffer area, this is typically contained 
within the region pointed to by cds 'area 'base. 

COMPOSITE 'STATUS 'BASE - word pointer to the area that contains 
composite status. Composite status is the logical "OR" of amy 
device status reports that are received during any one call to 
the logical driver. 

DEV STATUS 'BASE - a word pointer which contains the CBIX 
relative address of the base of the device status buffer area, 
which is used to store incoming device status reports. 

ENV' STATUS 'BASE - a word pointer which contains the CBIX 
relative address of the base of the environmental status 
buffer, which is used to store incoming device environmental 
status reports. 

JOB 'REPORT 'BASE - a word pointer which contains the CBIX 
relative address of the base of the job report buffer area, 
which is used to store incoming job reports. 

EXPANDED 'FEATURES - a logical flag which is set to true when 
a driver call is performed requesting access to the 
extended features of the peripheral. This access may not be 
granted if the caller has insufficient capability. The 
default is that the user is not in expanded features mode. 
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INPUT 'SEQUENCE 'COUNT - an integer counter which contains the 
input record sequence count. This value is used in error 
checking to determine if the protocol at the logical level 
has been violated (such as an entire record lost). This 
counter is set to zero upon completion of a device clear 
sequence, and increments by one after reception of an input 
record. 

OUTPUT 'SEQUENCE 'COUNT - an integer counter which contains the 
output record sequence count. Each time a record is sent 
to the peripheral, this value is incremented by one. The 
peripheral maintains a similar count, which it uses to 
perform error checking on the records it receives. This 
counter is set to zero upon completion of a device clear 
sequence . 

RECEIVE 'READY 'COUNT - an integer counter which maintains the 
number of available buffers in the peripheral. This count 
is increased by the value the peripheral sends in its 
RECEIVE READY report, and is decremented by one each time 
a record is sent to the peripheral. If the count ever 
reaches zero, then the logical driver must wait for a 
RECEIVE READY before it can send any more records. 

CPR'XLATE 'FLAGS - a double integer which is used by the 
CIPER function code translator during its process of trans- 
lating MPE function codes into device recognizable 
commands . 

SEQUENCE '1' BUFFER - a word pointer which contains the CBIX 
relative address of an array used by the CIPER function code 
translator to buffer any escape sequences which must be 
placed ahead of the user's data. 

O'R'DATA'TYPE - an integer which contains a code signifying 
the type of data being currently sent to the peripheral. 
This is initially set to zero (specifies user data with 
the control mask invoked) , but it may be changed by an 
appropriate call to the logical driver. 

I'R'DATA'TYPE - an integer which contains a code specifying 
the type of data requested from the peripheral by the user. 
This is initially set to zero (specifies responces to user 
escape sequences) but may be changed by an appropriate call 
to the logical driver. 

FILE 'OPEN 'COUNT - an integer which counts the number of 
nested file open calls that have currently been made against 
the device. In the final version of CIPER, this count will 
be used to determine if the user is finished with the 
device so resources used by the logical driver may be 
returned to the system. 
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DEVICE 'ALLOCATED - set TRUE when the first FOPEN is requested. 
Set FALSE upon completion of device close request. 

LOGICAL 'DEVICE - an integer which is used to store the 
logical device number of the device for which this data 
segment has been allocated. The logical driver will pass 
this value on to lower levels, as it must reach the 
physical driver. 

CTPER'DST - an integer which is used to store the data 
segment number of this data segment. The logical driver will 
pass this down to lower levels, as it must reach the 
physical driver. 

OUT 'RECS' OVERWRITTEN - an integer counter which tallies the 
number of times a device clear command had to be written 
over an output record buffer of user data. This is used 
for internal debugging and protocol validation only. 

IN 'RECS' OVERWRITTEN - an integer counter which tallies the 
number of times a CLEAR RESPONCE has overwritten user's 
data in the input record buffer area. This is used for 
internal debugging and protocol validation only. 

DEVICE 'BUFFER' SIZE - an integer which contains the size, in 
bytes, of the peripheral's record maximum record size. 
This information is returned in the peripheral's CLEAR 
RESPONCE. 

DEVI CE'ENV' STATUS 'SIZE - an integer which contains the size, 
in bytes, of the peripheral's largest environmental status 
report. This information is returned in the peripheral's 
CLEAR RESPONCE. 

PRODUCT 'NUMBER - a word pointer which contains the CBIX 
relative address of a buffer area used to store the ASCII 
encoded product number of the peripheral. This information 
is returned in the peripheral's CLEAR RESPONCE. 

STORAGE 'REQUIREMENTS - an integer which contains the size 
in words, of the region in the CIPER data segment that the 
logical driver requires for its buffer areas and other 
storage. The value contained does not include the size of 
the CBIX. 

TEMP'AREA - a word pointer which contains the DB relative 
address of a small region of the CIPER data segment which 
is allocated only during the initialization phases, then 
later released. 
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CT'PTR - a word pointer which contains the DB relative 
address of the control table for the logical device. This is 
a backward pointer. 

PACKET 'HEADER 'SIZE - an integer which contains the size, in 
bytes, of the Level 2 packet header. This value is used 
by the logical driver to reserve space at the front of the 
record for use by the network protocol level. 

PACKET'TRAILER'SIZE - an integer which contains the size, in 
bytes, of the Level 2 packet trailer. This value is used 
by the logical driver to reserve space at the front of the 
record for use by the network protocol level. 

PACKET 'SIZE - indicates size, in bytes, of level U packet. 

DEV'CLR' COUNT - count of current recursion level in B08 'DEVICE 'CLR. 
If preset limit exceeded, we give up. 

DEV'CLR 'IN 'PROGRESS - a count of how many times the DEVICE 
CLEAR procedure has been recursively entered. If this 
count exceeds a preset level, then the DEVICE CLEAR has 
been unable to restore normal communications with the 
device, probably due to a catastrophic hardware malfunction. 

SR 'ENABLE - configuration information used to construct a 
CONFIGURE record in the event the device powerfails and must 
be initialized. 

ESB'FREQUENCY - configuration information that tells the device 
how many checkpoints can occur before the transmission of an 
environmental status block becomes mandatory. 

LOGGING' DST - the data segment number of a DST used for 
performance evaluation. This DST will not be allocated when CIPER 
is released. 

LOGGING 'BUFFER - contains the CBIX relative address of an area 
used for construction of log entries for performance logging. 

EVENT 'MAP - a bit map that describes which performance events 
(currently there is only one type defined) are to be logged. 

STATUS 'ENABLED - a bit map set by the caller (spooler) which 
defines the types of peripheral status reports the caller is 
interested in receiving. When (if) any of the enabled types 
is received, the caller will be notified via a special return 
code (%hl). 
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STATUS 'RECEIVED - bit map of which status types have been 
received since the last time the caller read those status 
reports . 

STATUS' REPORTED - bit map of which status types that have been 
received have been reported to the caller via the %kl status 
return code. 

DEFAULT' ACCESS 'MODE - during initialization, set TRUE if 

device subtype=9, otherwise, set FALSE. Indicates whether 

access mode is FEATURE or TRANSPARENT after a start of job request. 

COMP' STAT 'AVAILABLE - set to TRUE whenever a new version of 
composite status becomes available. Set to FALSE whenever 
composite status is either read or cleared. 



Level It Control Block Information (CBI) 



Word 

1 
2 
3 
It 
5 



LVL'2'HEADER'SIZE 



LVL' 2 'TRAILER 'SIZE 



LVL'2'PACKET'SIZE 



HEADER 'MOVE 'SIZE 



TRAILER 'MOVE 'SIZE 



INITIALIZED 



Discussion: 

LVL '2 'HEADER 'SIZE - Contains the number of words required by the 
physical driver (CIPER level 2) for frame headers. Returned by 
the physical driver during initialization. 

LVL '2 'TRAILER 'SIZE - Contains the number of words required by the 
physical driver (CIPER level 2) for frame trailers. Returned 
by the physical driver during initialization. 

LVL '2 'PACKET 'SIZE - Contains the size (in bytes) of the largest 
frame the physical driver can accept in one call. Returned by 
the physical driver during initialization. 

HEADER 'MOVE 'SIZE - Contains the combined number of words (level It 
and level 2) that must be moved to make room for packet and 
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frame trailers. 

TRAILER 'MOVE' SIZE - Contains the combined number of words (level U 
and level 2) that must be moved to make room for packet and frame 
trailers . 

INITIALIZED - Set to TRUE if the CBI has been successfully 
initialized. Otherwise, set to FALSE. 



Control Block Information Extension 



The first table is a typical sub-area within the CBIX, such as is 
used for status tanks, buffer areas, etc. The second table actually 
shows the order of the different sub-areas within the CBIX. This 
CBIX is for Level 7» the Logical Driver. 



General Entry Format 



Word 

-1 



1 

2 



N 



LENGTH 



N+2 



NOTE: LENGTH - Is the size of the sub-area, including the length 
word itself. Thus, length ALWAYS contains N+2. 

Each entry in the CBIX has the general from of the above entry. 



Level Seven Control Block Info Extension (CBIX) 

The following describes the current CBIX form for level seven. 
Note that in this layout, the drawing is not to any scale. 
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Level Seven CBIX (Continued) 



AVAILABLE 



AVAILABLE 



AVAILABLE 



DEDICATED INPUT 



DEDICATED OUTPUT 



DEVICE STATUS TANK 



COMPOSITE STATUS TANK 



ENVIRONMENTAL STATUS BLOCK TANK 



JOB REPORT TANK 



CPR'XLATOR BUFFER 



PRODUCT ID 



LOGGING BUFFER AREA 



Record Buff 
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Level 7 CEIX (Continued) 



NOTES: 



Device status tank actually holds two copies - one copy of the 
previous report is used to compare against a new copy to see if 
any states have changed (such as going from on-line to offline). 

Composite status is the logical "OR" of all device status reports 
received during a particular call to the logical driver. This 
was done to reduce the possibility of the calling program missing 
an error condition due to multiple device status reports 
over-writing themselves. The area is cleared out at the 
start of most calls to B08'L0GICAL'DVR, so only those status 
reports which are received during the call will be returned . 

The logging buffer area is allocated all of the time, but the 
code to use it is not in place unless SOFTIO is compiled with 
the X7 toggle set "ON." When logging, this area is used to 
construct a log record before writing it to a logging data 
segment. The head entry of the current logging DST is kept 
in the logging buffer. 

Five record buffer areas are allocated during initialization. 
One is used as a dedicated output buffer, one is a dedicated 
input buffer, and the other three are linked into a free-list. 
The free-list buffers are used to send asynchronous requests 
(e.g. ESB Immediate) without disturbing a record under construction 
(such as a write data record). 
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Typical Record Buffer Area 



Word 

-1 

1 
2 
3 
k 

5 
6 

7 
8 



N 



LENGTH 



FORWARD 'LINK 



ALLOCATED 



ACTIVE 



READY 



START 



CURRENT' POSITION 



CURRENT 'LENGTH 



MAXIMUM'SIZE 



Area reserved for 

lower level 

headers, if any. 



Buffered data 
and level seven 
record header. 



DATA AREA 



Area reserved for 
lower level trailers, 
if any. 



Control 
Portion 

1 



J 



Data 
Portion 
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Discussion: 

Control Portion 

LENGTH - Is the number of words, including the length word, 
allocated to a particular buffer area. 

FORWARD'LINK - Is used if the buffer area is linked in a free-list. 
If so, FORWARD'LINK contains the CBIX relative address of the next 
buffer in the list. Otherwise, contains a zero. 

ALLOCATED - Is set FALSE if the buffer area is in the 
free-list. It is set to TRUE when not in the free-list. 

ACTIVE - Is set to TRUE if the buffer area contains any pending 
data. 

READY - Is set to TRUE when a buffer area being used for 

output is ready for transmission (currently not being used for this 

release) . 

START - Is an offset (in words) to the start of the data portion 
of the buffer area. The offset is relative to the zeroth word of 
the control portion (not the -1 word!!!). 

CURRENT' POSITION - Is an offset (in bytes) to the next available 
byte in the data portion. The offset is relative to the zeroth 
word of the control portion (not the -1 word!!!). 

CURRENT 'LENGTH - Contains a count (in bytes) of the data currently 
contained in the data portion. 

MAXIMUM 'SIZE - Contains the maximum number of bytes that a record 
may contain. This quantity is a device dependent value. 

Data Portion 

This is where a record going to or coming from the peripheral is 
assembled or interpreted. In the case of the HP 2b08S, the first 
four (U) bytes are always the record header. 

The amount of space required by lower levels for headers and 
trailers is determined at initialization and the appropriate 
number of words allocated when the record buffer area is set up. 
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Logical Device Table Extension (LDTX) 



The LDTX is the last of three tables in the LDT data segment, 
to Chapter 13 for a full description of these tables. 
The procedure B08 'Logical' Driver uses the CIPER entry to 
locate and access the CIPER data segment. 



Refer 



DST %16 = 1U 

SIR %12 ■ 10 

Zero Entry 



1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 

,JU— J,^^ I— .1 ,d m 'I'' 111 





1 
2 
3 
1* 



Highest Entry 



Entry Size 
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CIPER Entry 




1 
2 
3 
k 






1 


2 


3 


k 5 6 7 8 


9 


10 11 12 13 l*t 15 








1 





reserved 


DB 





CIPER Device Control Data Segment (CDCDS) 


DN 


CTM Index for this device (CTMI) 









Discussion: 

0.(2:1): This logical device uses the CIPER protocol. 

CTMI: Control Table Map Index (an index into 

the Control Table Map (CTM) which is located 

in the Ciper Device Control Data Segment (CDCDS)). 

DN: Ciper is shutdown. If set» an internal data 
integrity error has occurred and the device has been 
locked out from user access. 

DB: If set to 1, then debugging in effect. 
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HIOCIPRO DIT (HP2608S) 



There is one DIT per physical device. If a physical device represents 
more than one logical device, the logical device number is obtained 
from the IOQ element (however, this driver only supports one device per 
controller. ) The following diagram shows the DIT used for the HP- IB 
CIPER physical driver. 



Word 





1 


2 


3 


U 


5 


6 


7 


8 


9 


10 


11 


12 

i 


13 l 1 * 15 
i i 


MNEMONIC 











AC 


RQ 











10 


IA 


NO 


ST 









1 


SYSDB relative pointer to the DIT for the next 
device requesting this resource or service 


DLINK 


2 


SYSDB relative pointer to the first IOQ in 
request list for this device 


DIOQP 


3 


IOT 


Phys. unit 


Logical device number 


DLDEV 


1+ 


SYSDB relative pointer to Device Linkage Table 


DDLTP 


5 


SYSDB relative pointer to Intrp Linkage Table 


DILTP 


6 


VS 


AB 


RE 


TP 


NR 


NR CNT 


DEVICE STATUS 




7 


Hardware error status. Set when the driver 
detects an error. Whenever <0, the driver 
monitor logs an I/O error and clears this word 


DSERR 


8 


Bit is set at completion of timer 


DTIME 


9 


Holds the time out request entry index while 
a timer is active. 


DRQST 


10 


RF 


UE 


DE 


TO 


UNIT CNT 


DATA CNT 


TO CNT 


PRTY CNT 




11 


Error logging location 1 


DLOGERROR 


12 


Error logging location 2 


DL0GC0UNT 



DFLAG - Flags and request state 

AC ACTIVE - A monitor is currently servicing this device. 

RQ REQUEST - A service request is pending while the monitor is 
active. 
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10 I0PR0G - An I/O Channel Program is running for this device. 

IA IAK - An interrupt or response has occurred for this device. 

NO NOTRDY - Go to state J&10 after Idle Channel Program is started. 

ST STWAIT - The device monitor is starting an Idle Channel Program 
for this device. There is no IOQ associated with this 
type of request. 

STATE - State of the device monitor. Specifies the next action 
to be taken in SIODM in servicing the request: 

- start new request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver completor procedure 
U - not used 

5 - process request completed 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

%10 - wait for interrupt (operator intervention) 

restart at state 
Jill - wait for data segment freeze, then state 2 
%12 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 
%13 - wait for I/O completion interrupt, then state 3 
%lk - wait for controller, then call driver initiator 
Jtl5 - not used 

%l6 - wait for initiator make present, then state 2 
%17 - wait for completor make present, then state 3 

DLDEV - I/O system type, unit and logical device number 

- HP3000 Series 2/3 

1 - HP3000 Series 33 (HPIB) 

2 - Unused 

3 - Unused 

DSAVE - Device processing flags 

VS - VALID STATUS - Set to indicate Device Status has been updated. 
AB - DVRABFLAG - Sequence Abort in progress due to ABORT request. 
RE - RETRYFLAG - Sequence Abort in progress due to an error. 
TP - TIMERPOPPED - Current error is due to software timer popping. 
NR - NOTRDYFLAG - Not Ready Wait in progress. 
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NR 


CNT 




DEVICE STATUS 




BIT 


8 




BIT 


9 




BIT 


10 




BIT 


11 




BIT 


12 




BIT 13 




BIT 


1U 




BIT 


15 



Number of Not Ready Waits during this request. 

Device status returned during a Sequence Abort. 

CRC available and enabled. 

Reserved. 

Reserved . 

Reserved . 

Power fail or reset has occurred. 

A protocol error has been detected. 

A parity error has been detected. 

The peripheral has data to send. 



DSERR - Pointer to status to be logged. 



Bits. (0:8) 
Bits. (8:8) 

DCOUNTS 

RF - REQ FAILED 

UE - UNIT ERROR 

DE - DATA ERROR 

TO - TIME OUT 

UNIT CNT 

DATA CNT 

TO CNT 

PRTY CNT 



- Number of words to be logged. 

- Offset relative to DITP(O). 

- Error flags and error counts (It). 

- An error has forced this request to be aborted. 

- The current error is a Unit Error. 

- The current error is a Data Error. 

- The current error is a GIC Time Out Error. 

- Number of Unit Errors during this request. 

- Number of Data Errors during this request. 

- Number of GIC Time Outs during this request. 

- Number of HP-IB Parity Errors during this request. 
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CIPER IOQ Element 



Word 


1 

2 
3 
k 

5 
6 



8 

9 
10 



1 2 3 U 5 6 7 8 9 10 11 12 13 l 1 * 15 



MNEMONIC 



Request dependent flags (see below) 
■ ■ i i ' ' i I I I 1 1 1 I L 



SYSDB relative pointer to next IOQ element. 
Points to first word of element. 



Logical device number 



If QFLAG.(3:1) is clear then this is the 
DST number of the target data segment. If 
S is set, QADDR is DB relative. 



Offset in the data segment or system buffer 
table to the target data buffer. 



Used by the new Disc 
routines for special 
status returns. 



Function code for 
this request. (See 
next section.) 



On initiation, specifies the word count (0) 
or byte count (<0). At completion of the 
request this location contains the actual 
transmission count in the same units (bytes 
or words) as in the request. 



Parameter 1. 



Parameter 2. 



PCBN 



QUALIFIER 



RSTATUS 



QFLAG 
QLINK 

QLDEV 
QMISC 
QDSTN 

QADDR 
QFUNC 

QWBCT 



QPAR1 
QPAR2 
QSTAT 



QFLAG - Request dependent flags 



Bit ABORT 

Bit 1 SPECIAL 

Bit 2 DIAG 

Bit 3 SYSBUFF 



Abort this request and return an error indication 



"co xne caj.xei- 



- Apply special handling to this request. (Not used) 

- This is a request from the diagnostic subsystem. 

- Target is an index relative to the SBUF Table of 
the data buffer. 
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Bit k IOWAKE 
Bit 5 BLOCKED 

Bit 6 COMPLETED 



- Wake caller on completion of request. 

- Blocked I/O. The caller is waited in ATTACHIO 
until the request is completed. Implies IOWAKE. 

The request has been completed and the caller 
awakened if he had requested (with IOWAKE). 



Bit 7 DATAFRZN - Set by the memory management routines (MAM) when a 

MAKEPRESENT request is successfully completed and 
indicates the data segment is frozen in memory. 



Bit 8 MAMERRORD 

Bit 9 PREQ 
Bit 10 SFAIL 



Bit 11 PFAIL 



An error has occurred while MAM was trying to 
make the target data segment present and freeze 
it in memory. 

- (Not used) 

- Delayed failure of SIO instruction. If a call to 
STARTIO resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed when the request was selected 
for execution. 

- The request was aborted because of a system power 
failure. 



QSTAT - PCB number and request completion status. 
PCBN 



RSTATUS 



QUALIFIER - 

General Status (13: 

- Pending 

1 - Successful 



The Process Control Block (PCB) number of the process 
which made this request. If zero, the request is not 
associated with any process and the IOQ element is to 
be returned by the system when the request has completed. 

General status indicating the final state of the request. 
The following codes are used: 

- Not started or awaiting completion. 

1 - Successful completion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 
U - Irrecoverable error has occurred. 

A code which further defines or qualifies the general 
status . 



3) Qualifying Status (8:5) 

1 - Waiting For Completion 
3 - Not Ready Wait 

- No Errors 



Overall (8:8) 



£L0 
%30 

%1 
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End of File 



(Not Used) 



Unusual Condition 



k - Irrecoverable Error 



3 - Request Aborted 

6 - Powerfail Abort 

%21 - Device Powered Up 



*33 

%63 

%213 



- Invalid Request %j+ 

1 - Transfer Error %14 

2 - I/O Timed Out Before Complete %2k 
k - SIO Failure %W 
5 - Unit Failure %5^ 

%12 - System Error %12U 

%lk - Channel Failure %lbk 

%21 - Parity Error %2lU 



Device Reference Table 

There is one DRT per device controller. The contents of this 
table are used for processing interrupts. 



Word 


1 
2 
3 



1 2 3 U 5 6 7 8 9 10 11 12 13 l 1 * 15 MNEMONIC 
■ ' i i i i i i i 



Channel Program Pointer (SIOP) 



Channel Program Variable Area pointer (CPVA) 



Interrupt Handler Program Label 



ST 



SH 



PF 



( status ) 



WS 



GF 



DT 



WT 



DRTO 
DRT1 
DRT2 
DRT3 



DRT3 



Bit 



- ST, Channel Program Status; - halted, 

1 - SH, SIOP or HIOP instruction pending 

2 - PF, Power Fail recovery in progress 

12 - WS, Waiting for device status request 

13 - GF, GIC FIFO buffer not empty 
lU - DT, DMA transfer active 



running 






Channel PTocrani in Wait state 
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Interrupt Linkage Table 



There is one ILT for each device controller configured on the system. 
A controller may support more than one unit, however the HP-IB CIPER 
physical driver currently only supports one unit. 



Word 


1 
2 

3 
l» 

5 
6 

7 
8 

9 
10 



11 

12 
13 
Ut 

15 
N 



1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 
i i i i i i i i i i i i i i i 



Channel 

Program 

Variable 

Area (ICPVA) 



DMA 



Abort 



Address 



LI 



CHANQUE 



CHAN 



DEV 



SYSDB relative pointer to Channel Program area 



SYSDB relative pointer to Status Return area. 
(Always zero for this driver.) 



single instruction that is executed to extract 
the device unit number from the status pointed 
to by ISTAP. (Since there is only one unit 
on the controller, this entry is not used.) 



SYSDB relative DIT pointer of the device 
currently using the channel to perform a 
data operation. 



SIOPSIZE 



RW 



WP 



IG 



CQUEN 



HCUNIT 



SYSDB relative DIT pointer for unit 



Peripheral 
Channel 
Program 



(Variable length) 



MNEMONIC 



ICPVAO 

ICPVA1 

ICPVA2 

ICPVA3 

ICPVAU 

ICPVA5 

ISRQL 

ICNTRL 

ISIOP 

ISTAP 

IUNIT 



ICDP 

IQUEUE 

IFLAG 

IDITPO 
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ICPVAO/3 - Channel Program Variable Area 

The first word is used by the channel program processor to store 
status information after I/O channel aborts. The next word is used 
by the driver to indicate if status should be examined for special 
conditions or errors. The other two words are not used. 

ICPVAU/5 - DMA abort address 

If a DMA abort occurs, the absolute address where the abort occurred 
is stored in this area. 

ICNTRL - Contains controller information 

LIM - If this bit is set, the controller is sharing a software 
channel resource in order to limit bandwidth. 

CHANQUE - The software channel resource number. 

CHAN - Channel number (four most significant bits of DRTN). 

DEV - Device number (three least significant bits of DRTN). 

IQUEUE - 

SIOPSIZE - (number of words + l)/2 in the channel program area. 

CQUEN - For a multi-unit controller this field contains the 
software controller resource number. 

IFLAG - Controller and Channel Program state flags 

RUNWAIT - An Idle Channel Program should be started when there 

are no active requests to process. This flag is always 
for this version of the driver. 

WAITPROG - An Idle Channel Program has been started for this 
controller. This bit is reset by an interrupt. 

IGNOREHI - An HIOP instruction has been issued against this controller 
but the channel program was not in a wait 
statement. Therefore ignore the interrupt generated by 
the channel code when this program halts. 

HCUNIT - Highest configured unit number for this controller. 
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